如何修改Ubuntu的PHP配置

如何修改Ubuntu的PHP配置

修改PHP配置是日常运维中非常常见的操作。无论是调大上传文件限制，还是调整内存上限，核心步骤其实就那么几步。下面直接进入正题。

1. 准备工作：确定PHP版本和配置文件路径

在动手修改之前，有两件事必须先搞清楚：你当前用的是哪个版本的PHP，以及对应的配置文件具体在什么位置。

• 查看PHP版本：在终端里执行下面这条命令，输出结果中的主版本号（比如 8.1、7.4）就是关键信息：

  php -v

• 查找配置文件路径：接着运行这条命令，找到 Loaded Configuration File 这一行，它后面跟着的就是 PHP 正在加载的 php.ini 文件路径：

  php --ini

  输出示例：

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

  不同使用场景下的配置文件位置是不同的，这一点容易混淆：
  • 命令行模式：/etc/php/{版本号}/cli/php.ini（比如 /etc/php/8.1/cli/php.ini）
  • Apache Web服务器：/etc/php/{版本号}/apache2/php.ini（比如 /etc/php/8.1/apache2/php.ini）
  • Nginx + PHP-FPM 模式：/etc/php/{版本号}/fpm/php.ini（比如 /etc/php/8.1/fpm/php.ini）

2. 编辑php.ini配置文件

确定了文件路径后，用文本编辑器打开它。注意，因为这是系统级配置文件，所以需要管理员权限，命令前要加 sudo：

sudo nano /etc/php/8.1/cli/php.ini  # 把路径换成你实际找到的那个

文件打开后，可以搜索并修改以下常见配置项。在 nano 里，按 Ctrl+W 或者直接输入 / 可以快速定位配置名（比如输入 /upload_max_filesize 直接跳转）。

• 调整上传文件大小限制：找到 upload_max_filesize，修改成你需要的值，比如 100M：

  upload_max_filesize = 100M

• 调整脚本内存限制：找到 memory_limit，设置单个 PHP 脚本能使用的最大内存，比如 256M：

  memory_limit = 256M

• 调整脚本执行时间：找到 max_execution_time，单位是秒。如果脚本运行时间比较长，可以改成 300：

  max_execution_time = 300

• 启用OPcache加速（可选操作）：找到 opcache.enable，把它设为 1 即可开启。同时可以调整 opcache.memory_consumption（内存占用，单位 MB）来优化缓存效果，比如设为 128：

  opcache.enable = 1
  opcache.memory_consumption = 128

3. 保存并退出编辑器

如果你用的是 nano，操作顺序是：先按 Ctrl + X 退出编辑模式，然后按 Y 确认保存，最后按 Enter 退出即可。

4. 重启相关服务使配置生效

修改完 php.ini 只是第一步，关键的一步是重启对应的服务，新配置才能生效。

• 命令行模式（只影响在终端执行的 PHP 脚本）：

  sudo systemctl restart php8.1-cli  # 版本号换成你自己的

• Apache Web服务器（影响通过 Apache 运行的 PHP 页面）：

  sudo systemctl restart apache2

• Nginx + PHP-FPM 模式（影响通过 Nginx 运行的 PHP 页面）：

  sudo systemctl restart php8.1-fpm  # 版本号换成你自己的
  # 如果修改了 Nginx 配置（比如 fastcgi_pass），也需要重启 Nginx：
  sudo systemctl restart nginx

  需要留心的是，如果你同时使用了 Apache 和 PHP-FPM，那两者都得重启。如果只用 Nginx + PHP-FPM，重启 PHP-FPM 就够了。

5. 验证配置是否生效

最后一步，验证修改是否真的被应用了。创建一个 info.php 文件，把它放到 Web 服务器的文档根目录（比如 /var/www/html/），内容就写：

然后在浏览器里访问 http://你的服务器IP/info.php，在打开的页面里搜索你修改过的配置项（比如 upload_max_filesize、memory_limit）。如果显示的值已经变成了你设置的数字，那就说明配置生效了。

注意事项

• 养成备份的好习惯：修改配置文件前，强烈建议先备份原文件。命令很简单：

  sudo cp /etc/php/8.1/cli/php.ini /etc/php/8.1/cli/php.ini.bak

  万一改错了，还能迅速恢复。
• 别忘加sudo：系统配置文件只有管理员才能编辑，不加 sudo 是保存不了的。
• 资源不是越多越好：调整 memory_limit 或 max_execution_time 时，要结合服务器的实际内存大小和业务需求来设定。设置得过高，反而可能导致服务器资源被耗尽，得不偿失。