温馨提示×

Ubuntu PHP配置如何操作

小樊
35
2026-08-12 12:43:17
栏目: 编程语言

下面分 常见场景 给你讲 Ubuntu 下 PHP 的配置操作,以 Ubuntu 20.04 / 22.04 + PHP 8.x 为主(PHP 7.x 也类似)。


一、安装 PHP(如未安装)

1️⃣ 更新软件源

sudo apt update

2️⃣ 安装 PHP(CLI + Apache / Nginx 常用)

sudo apt install php php-cli

3️⃣ 常见扩展安装

sudo apt install php-mysql php-curl php-xml php-mbstring php-zip php-gd

二、确认 PHP 版本与路径

php -v
which php

配置文件位置:

php --ini

通常输出类似:

Loaded Configuration File: /etc/php/8.1/cli/php.ini

三、PHP 配置文件结构(重点)

Ubuntu 下 PHP 配置分 SAPI

用途 配置目录
CLI(命令行) /etc/php/8.1/cli/php.ini
Apache /etc/php/8.1/apache2/php.ini
Nginx(FPM) /etc/php/8.1/fpm/php.ini

⚠️ 修改哪个取决于你用的 Web 服务


四、修改 PHP 配置(php.ini)

1️⃣ 编辑配置文件

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

2️⃣ 常见配置项

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

3️⃣ 保存并退出

Ctrl + OEnterCtrl + X


五、Web 服务器对应操作

✅ Apache

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

测试:

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

访问:

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

✅ Nginx + PHP-FPM(推荐)

安装

sudo apt install php-fpm nginx

修改 Nginx 配置

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

重启服务

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

六、PHP-FPM 常用配置

配置文件

/etc/php/8.1/fpm/pool.d/www.conf

常见项:

user = www-data
group = www-data
listen = /run/php/php8.1-fpm.sock

七、查看 PHP 是否生效

php -i | grep "upload_max_filesize"

或浏览器访问 phpinfo() 页面。


八、切换 PHP 版本(多版本)

sudo update-alternatives --config php

九、常见问题排查

1️⃣ 修改配置不生效

✅ 确认修改的是 正确的 php.ini
✅ 重启对应服务(Apache / PHP-FPM)

2️⃣ Nginx 访问 PHP 下载而不是执行

✅ 检查 fastcgi_pass 是否正确
✅ PHP-FPM 是否运行


十、总结一句话

Ubuntu 下 PHP 配置 = 修改 /etc/php/*/php.ini + 重启 Web 服务


如果你愿意,可以告诉我:

  • ✅ 用的是 Apache 还是 Nginx
  • ✅ PHP 版本
  • ✅ 想改什么配置(上传大小 / 性能 / 安全)

我可以给你 精确到命令级别 的配置方案。

0