Ubuntu下PHP如何配置

下面给你一份 Ubuntu 下 PHP 配置完整指南，从 安装 → 配置 PHP → 与 Web 服务器对接（Apache / Nginx） → 常用参数说明，适合新手和实际操作。

一、安装 PHP（Ubuntu）

✅ 1. 更新系统

sudo apt update
sudo apt upgrade -y

✅ 2. 安装 PHP（默认版本）

sudo apt install php -y

查看版本：

php -v

✅ 3. 安装指定 PHP 版本（推荐）

例如 PHP 8.2（Ubuntu 22.04+ 推荐）：

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.2

二、安装常用 PHP 扩展

sudo apt install php8.2-cli php8.2-fpm php8.2-mysql \
php8.2-curl php8.2-gd php8.2-mbstring \
php8.2-xml php8.2-zip php8.2-bcmath php8.2-json

⚠️ Ubuntu 20.04+ 中 php8.2-json 已内置

三、PHP 配置文件位置

✅ 主配置文件

/etc/php/8.2/

目录结构：

/etc/php/8.2/
├── cli/php.ini        # 命令行 PHP
├── fpm/php.ini        # PHP-FPM（Nginx 常用）
├── fpm/pool.d/www.conf

四、PHP 与 Web 服务器对接

✅ Apache + PHP

1. 安装 Apache

sudo apt install apache2

2. 安装 Apache PHP 模块

sudo apt install libapache2-mod-php8.2

3. 启用 PHP

sudo a2enmod php8.2
sudo systemctl restart apache2

4. 测试

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

浏览器访问：

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

✅ Nginx + PHP（推荐）

1. 安装 Nginx

sudo apt install nginx

2. 启动 PHP-FPM

sudo systemctl start php8.2-fpm
sudo systemctl enable php8.2-fpm

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 ~ \.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 /etc/php/8.2/fpm/php.ini

✅ 常用参数

参数	说明	推荐
upload_max_filesize	上传文件大小	64M
post_max_size	POST 数据大小	64M
memory_limit	内存限制	256M
max_execution_time	最大执行时间	300
date.timezone	时区	Asia/Shanghai

示例：

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

六、查看 PHP 错误日志

PHP-FPM 日志

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

Nginx 日志

/var/log/nginx/error.log

开启 PHP 错误显示：

display_errors = On
log_errors = On
error_reporting = E_ALL

七、检查 PHP 是否正常工作

php -r "echo PHP_VERSION;"

或创建：

/var/www/html/test.php

<?php
phpinfo();

八、常见错误

❌ 502 Bad Gateway

PHP-FPM 未启动
sock 路径错误

sudo systemctl status php8.2-fpm

❌ 页面直接显示 PHP 代码

Nginx 未解析 PHP
Apache 未加载 PHP 模块

九、总结

✅ Ubuntu 下 PHP 配置流程：

安装 PHP
安装扩展
选择 Apache / Nginx
修改 php.ini
重启服务
测试 phpinfo()

如果你愿意，我可以： ✅ 帮你写 LNMP / LAMP 一键安装方案 ✅ 针对 Laravel / ThinkPHP / WordPress 优化配置 ✅ 排查具体报错（贴日志即可）