Debian PHP配置中如何选择合适的扩展

Debian PHP扩展选择指南

一 选择原则与版本匹配

• 明确应用类型与依赖：优先选择框架/CMS官方文档标注的扩展（如 Laravel/Symfony 常见要求 mbstring、openssl、pdo_mysql、curl、gd/xdebug 等）。
• 保持版本一致：所有扩展包必须与所选 PHP 主版本一致（例如 php8.2-mysql、php8.2-fpm），否则不会加载或冲突。
• 区分运行环境：CLI 与 FPM/Apache 有各自的 php.ini（如 /etc/php/8.2/fpm/php.ini 与 /etc/php/8.2/cli/php.ini），按场景分别调整。
• 安装即启用：Debian 的打包方式会自动启用扩展，通常无需在 php.ini 手动添加 “extension=xxx.so”。
• 安全与性能基线：生产环境建议启用 OPcache，关闭 display_errors，打开 log_errors，并合理设置 cgi.fix_pathinfo=0。

二 扩展选择清单与推荐组合

三 安装与启用步骤

• 安装指定版本与扩展（示例为 PHP 8.2）：
  sudo apt update
  sudo apt install php8.2 php8.2-cli php8.2-fpm php8.2-mysql php8.2-curl php8.2-gd php8.2-mbstring php8.2-xml php8.2-zip php8.2-bcmath php8.2-json
  说明：Debian 打包会自动启用扩展，无需在 php.ini 中手动添加 “extension=xxx.so”。

• 与 Web 服务器集成：

  • Nginx：安装 php8.2-fpm，在站点配置中使用 fastcgi_pass unix:/run/php/php8.2-fpm.sock; 并确保 SCRIPT_FILENAME 正确。
  • Apache：可使用模块方式（libapache2-mod-php）或 proxy_fcgi 方式对接 PHP-FPM。

• 使配置生效：

  • 修改 /etc/php/8.2/fpm/php.ini 或 /etc/php/8.2/cli/php.ini 后，重启 php8.2-fpm 或 apache2。
  • 修改 Nginx/Apache 站点配置后，先执行语法检查（如 nginx -t），再重载服务。

四 验证与性能安全优化

• 验证扩展是否加载：
  创建 /var/www/html/info.php，内容为 ，访问确认模块与配置；完成后删除该文件以避免信息泄露。

• 性能与安全基线：

  • 启用 OPcache（Debian 包通常默认启用，可在 php.ini 检查）：
    opcache.enable=1
    opcache.memory_consumption=128
    opcache.max_accelerated_files=10000
  • 资源与上传：
    memory_limit=256M；max_execution_time=300；upload_max_filesize=100M；post_max_size=100M（按业务调整）。
  • 安全：
    display_errors=Off；log_errors=On；cgi.fix_pathinfo=0；必要时限制危险函数（如 exec、system、shell_exec 等）。

五 常见问题与排查

• .php 显示源码或下载：未正确接入 PHP 处理器。Nginx 核对 fastcgi_pass 与 SCRIPT_FILENAME；Apache 确认启用对应模块或 proxy_fcgi 配置。
• 扩展未生效：扩展包与 PHP 版本不一致（如 php8.2-mysql 与 php8.1 混用），或忘记重启 FPM/Apache。
• FPM 无法连接：检查 /run/php/php8.2-fpm.sock 的权限与属主（常见为 www-data），以及 listen 地址与 Web 服务一致。
• 配置未生效：区分 CLI/FPM/Apache 的 php.ini，修改后需重启对应服务。