Debian系统PHP如何正确配置

Debian系统PHP正确配置全流程

一 准备与版本选择

• 更新索引并确认可用版本：
  • sudo apt update
  • apt-cache policy php
• 安装默认版本（以当前仓库为准，常见为PHP 8.2）：
  • sudo apt install php
• 安装指定版本（示例：PHP 8.2 或 PHP 7.4）：
  • sudo apt install php8.2
  • sudo apt install php7.4
• 说明：选择与项目兼容的版本，后续所有 php-* 扩展与 FPM 包都要与所选版本保持一致（例如 php8.2-fpm、php7.4-mysql）。

二 安装与启用常用扩展

• 通用扩展建议（按需增减）：
  • sudo apt install php-cli php-fpm php-json php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath
• 安装完成后无需在 php.ini 中手动添加“extension=xxx.so”，Debian 的打包方式会自动启用；重启对应服务使扩展生效（见下一节）。

三 Web服务器整合

• 使用 Apache（模块方式）
  • 安装模块：sudo apt install libapache2-mod-php
  • 启用对应版本模块（如8.2）：sudo a2enmod php8.2
  • 重要安全项：编辑 /etc/php/8.2/apache2/php.ini，将 cgi.fix_pathinfo=1 改为 cgi.fix_pathinfo=0
  • 重启：sudo systemctl restart apache2
• 使用 Nginx（PHP-FPM 方式）
  • 安装 FPM：sudo apt install php8.2-fpm
  • 配置监听（/etc/php/8.2/fpm/pool.d/www.conf）：
    • 推荐 Unix Socket：listen = /run/php/php8.2-fpm.sock
    • 或 TCP：listen = 127.0.0.1:9000
    • 确保用户组与 Web 服务一致：listen.owner = www-data；listen.group = www-data；user = www-data；group = www-data
  • Nginx 站点示例（/etc/nginx/sites-available/default）：
    • server { listen 80; root /var/www/html; index index.php index.html; location / { try_files $uri $uri/ =404; } location ~ .php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/run/php/php8.2-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } location ~ /.ht { deny all; } }
  • 检查并重载：sudo nginx -t && sudo systemctl reload nginx
  • 启动与开机自启 FPM：sudo systemctl start php8.2-fpm && sudo systemctl enable php8.2-fpm
• 说明：两种方式的 php.ini 分别位于 /etc/php/{version}/apache2/php.ini（Apache）与 /etc/php/{version}/fpm/php.ini（FPM）。

四 关键配置与优化

• 基础性能与安全（编辑 php.ini，按环境调整）：
  • 内存与执行：memory_limit = 256M；max_execution_time = 300
  • 上传与请求：upload_max_filesize = 100M；post_max_size = 100M
  • 开发/生产差异：
    • 开发：display_errors = On；error_reporting = E_ALL
    • 生产：display_errors = Off；log_errors = On
  • 缓存加速：确保启用 OPcache（Debian 包通常默认启用，可在 php.ini 检查 opcache 相关项）
• 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
  • 套接字与权限：listen.owner/group 与 Web 服务用户一致（常见为 www-data）
• 修改后重启对应服务（Apache 或 php**{version}**-fpm）。

五 验证与常见问题

• 验证安装：
  • 创建测试文件：echo “” | sudo tee /var/www/html/info.php
  • 浏览器访问：http://服务器IP/info.php，应看到 PHP 信息页
  • 删除测试文件：rm /var/www/html/info.php（避免信息泄露）
• 常见问题排查：
  • 访问 .php 显示源码或下载：多因未正确接入 PHP 处理器
    • Apache：确认已安装 libapache2-mod-php 且启用对应模块（a2enmod phpX.X），检查是否将 .php 交给 PHP 处理，必要时在配置中使用 SetHandler；重启 Apache 并查看日志 /var/log/apache2/error.log
    • Nginx：确认 fastcgi_pass 指向正确的 .sock 或 127.0.0.1:9000，并确保 SCRIPT_FILENAME 正确；执行 nginx -t 检查语法并重载
  • 扩展未生效：确认扩展包与 PHP 版本一致（如 php8.2-mysql），并重启 Web 服务或 FPM
  • FPM 无法连接：核对 /run/php/php**{version}**-fpm.sock 权限与属主、Nginx/Apache 配置路径一致性，以及 SELinux/AppArmor 是否限制（如启用需相应放行）。