PHP在Ubuntu怎么配置

在 Ubuntu 上配置 PHP，通常分为 安装 PHP、配置 PHP、与 Web 服务器（Apache / Nginx）配合使用 这几步。下面给你一份常用且实战向的完整流程。

一、更新系统（推荐）

sudo apt update
sudo apt upgrade -y

二、安装 PHP（含常用扩展）

1️⃣ 安装 PHP（以 PHP 8.2 为例，Ubuntu 22.04+ 默认源就有）

sudo apt install php php-cli php-fpm php-json php-mysql php-curl php-gd php-mbstring php-xml php-zip -y

✅ 常用扩展说明：

扩展	作用
php-cli	命令行 PHP
php-fpm	配合 Nginx
php-mysql	MySQL 支持
php-gd	图片处理
php-mbstring	多字节字符串
php-xml	XML 处理
php-zip	ZIP 支持

查看版本：

php -v

三、PHP 配置文件位置（重点）

Ubuntu 下 PHP 配置文件一般在：

/etc/php/8.2/

主要文件：

/etc/php/8.2/cli/php.ini      # 命令行模式
/etc/php/8.2/fpm/php.ini      # Web 模式（Nginx 用）

四、常用 PHP 配置项（推荐修改）

编辑配置（以 FPM 为例）：

sudo nano /etc/php/8.2/fpm/php.ini

推荐修改：

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 300
date.timezone = Asia/Shanghai

保存后重启：

sudo systemctl restart php8.2-fpm

五、与 Web 服务器配合使用

✅ 方式一：Apache + PHP（简单但性能一般）

安装 Apache

sudo apt install apache2 libapache2-mod-php -y

启用 PHP

sudo systemctl restart apache2

测试

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/info.php

浏览器访问：

http://服务器IP/info.php

✅ 方式二：Nginx + PHP（推荐，生产环境）

1️⃣ 安装 Nginx

sudo apt install nginx -y

2️⃣ PHP-FPM 配置

检查 sock 文件：

ls /run/php/php8.2-fpm.sock

3️⃣ Nginx 站点配置

编辑：

sudo nano /etc/nginx/sites-available/default

关键配置：

server {
    listen 80;
    server_name localhost;

    root /var/www/html;
    index index.php index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}

4️⃣ 重启服务

sudo systemctl restart nginx
sudo systemctl restart php8.2-fpm

六、测试 PHP 是否正常工作

sudo nano /var/www/html/test.php

内容：

<?php
phpinfo();

访问：

http://服务器IP/test.php

七、查看 PHP 错误日志

FPM：

tail -f /var/log/php8.2-fpm.log

Nginx：

tail -f /var/log/nginx/error.log

八、常见问题

✅ 1. 修改 php.ini 不生效？

确认修改的是 fpm/php.ini
重启 PHP-FPM：

sudo systemctl restart php8.2-fpm

✅ 2. Nginx 访问 PHP 显示 502？

PHP-FPM 没启动
sock 路径不匹配

九、总结一句话

Ubuntu 配 PHP：装 PHP + 改 php.ini + 配合 Apache/Nginx + 重启服务

如果你告诉我：

Ubuntu 版本（20.04 / 22.04 / 24.04）
用 Apache 还是 Nginx
做网站 / API / Laravel / WordPress

我可以给你一份完全定制化的配置方案 ✅