ubuntu php配置怎样才正确

ubuntu

小樊

2026-09-10 09:37:18

栏目: 编程语言

在 Ubuntu 上正确配置 PHP，通常取决于你是单独用 PHP CLI，还是配合 Nginx / Apache 使用。下面给你一套标准且不容易踩坑的配置思路（以 Ubuntu 20.04 / 22.04 + PHP 8.x 为例）。

一、安装 PHP（推荐方式）

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 PHP（以 PHP 8.1 为例）

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

✅ php-fpm 是 Nginx 必备
✅ Apache 用 libapache2-mod-php

二、PHP 基础配置（php.ini）

1. 找到 php.ini 位置

php --ini

常见路径：

CLI：/etc/php/8.1/cli/php.ini
FPM：/etc/php/8.1/fpm/php.ini

2. 常用正确配置

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

修改后重启：

sudo systemctl restart php8.1-fpm

三、Nginx + PHP 正确配置（最常见）

1. 安装 Nginx

sudo apt install nginx

2. 网站配置示例

server {
    listen 80;
    server_name example.com;
    root /var/www/html;

    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

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

3. 测试 PHP

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

访问：

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

四、Apache + PHP 配置（如果你用 Apache）

sudo apt install apache2 libapache2-mod-php
sudo systemctl restart apache2

无需手动配置 FPM。

五、权限问题（非常重要）

正确做法

sudo chown -R www-data:www-data /var/www/html
sudo chmod -R 755 /var/www/html

六、常见错误排查

问题	解决
502 Bad Gateway	php-fpm 没启动或 sock 路径错
空白页	看 `error_log`
文件上传失败	改 `upload_max_filesize`
时区错误	设置 `date.timezone`

七、推荐最终结构

/etc/php/8.1/
 ├── cli/php.ini
 └── fpm/php.ini
/var/www/html/
run/php/php8.1-fpm.sock

如果你愿意，可以告诉我：

✅ Ubuntu 版本
✅ PHP 版本
✅ 用 Nginx 还是 Apache
✅ 报什么错

我可以直接帮你写可用的配置文件。