如何修改Debian PHP配置

Debian 修改 PHP 配置的完整步骤

一准备与定位配置文件

确认 PHP 版本与 SAPI：运行 php -v 查看版本；运行 php -m | grep -E ‘apache2|fpm|cli’ 确认当前使用的 SAPI（如 apache2、fpm、cli）。
查找 php.ini 路径：运行 php --ini，关注 “Loaded Configuration File” 与 “Configuration File (php.ini) Path”。常见路径为：
- Apache：/etc/php/{version}/apache2/php.ini
- PHP-FPM：/etc/php/{version}/fpm/php.ini
- CLI：/etc/php/{version}/cli/php.ini
备份原始配置：例如 sudo cp /etc/php/8.2/fpm/php.ini /etc/php/8.2/fpm/php.ini.bak。
原则：修改哪一端就改对应的 php.ini（Web 请求看 apache2/fpm，命令行看 cli）。

二修改 php.ini 常用参数

编辑对应 SAPI 的 php.ini（以 /etc/php/{version}/{sapi}/php.ini 为例）：
- 内存与执行：
  - memory_limit = 256M
  - max_execution_time = 300
- 上传与 POST：
  - upload_max_filesize = 50M
  - post_max_size = 50M（应 ≥ upload_max_filesize）
- 时区：
  - date.timezone = Asia/Shanghai
- 错误报告（生产建议关闭显示、开启日志）：
  - display_errors = Off
  - log_errors = On
  - error_log = /var/log/php_errors.log
使配置生效：
- Apache：sudo systemctl restart apache2
- Nginx + PHP-FPM：sudo systemctl restart php{version}-fpm && sudo systemctl restart nginx
验证：
- CLI：运行 php -i | grep memory_limit（或 grep 其他指令）
- Web：创建 /var/www/html/info.php 内容为，访问确认。

三使用 PHP-FPM 与 Web 服务器集成

安装与启用：
- sudo apt install php{version}-fpm
- 启动与开机自启：sudo systemctl start php{version}-fpm && sudo systemctl enable php{version}-fpm
调整 FPM 进程池（按需）：编辑 /etc/php/{version}/fpm/pool.d/www.conf
- 进程管理：pm = dynamic
- 并发与回收：pm.max_children = 50、pm.start_servers = 5、pm.min_spare_servers = 5、pm.max_spare_servers = 35
Web 服务器与 FPM 对接：
- Nginx 示例：
  - location ~ .php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/run/php/php{version}-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; }
  - 检查并重载：sudo nginx -t && sudo systemctl reload nginx
- Apache 示例（启用 proxy_fcgi 后）：
  - <FilesMatch .php$> SetHandler “proxy:unix:/run/php/php{version}-fpm.sock|fcgi://localhost”
  - 重载：sudo systemctl reload apache2
说明：FPM 监听可为 Unix socket（如 /run/php/php{version}-fpm.sock）或 TCP 127.0.0.1:9000，两者在 Nginx/Apache 中对应配置即可。

四进阶优化与安全

启用 OPcache（强烈建议）：
- 安装：sudo apt install php{version}-opcache
- 配置（php.ini 的 [opcache] 段）：
  - opcache.enable=1
  - opcache.memory_consumption=128
  - opcache.interned_strings_buffer=8
  - opcache.max_accelerated_files=4000
  - opcache.revalidate_freq=60
生产环境安全：
- 关闭错误显示：display_errors = Off；开启日志：log_errors = On；自定义日志路径并确保可写。
- 目录限制（可选）：在 php.ini 设置 open_basedir 或在 .htaccess 使用 php_value open_basedir 限制脚本访问范围。
调试扩展（仅开发）：安装 php-xdebug 并在 php.ini 中配置 zend_extension=xdebug.so、xdebug.mode=debug、xdebug.client_host=127.0.0.1、xdebug.client_port=9003，重启服务后配合 IDE 使用。

最新问答