Apache2 Ubuntu版如何配置PHP

Apache2 Ubuntu 版配置 PHP 实操指南

一 安装与基础验证

• 更新索引并安装组件（以 Ubuntu 20.04/22.04 为例，默认仓库通常提供 PHP 7.4/8.1；如需 PHP 8.1，可启用 ppa:ondrej/php）：
  • 更新与安装 Apache：sudo apt update && sudo apt install apache2
  • 安装 PHP 与常用扩展（按需增减）：sudo apt install php libapache2-mod-php php-cli php-fpm php-json php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath
  • 启动并设置开机自启：sudo systemctl start apache2 && sudo systemctl enable apache2
• 验证 Apache 与 PHP：
  • 创建测试文件：echo “” | sudo tee /var/www/html/info.php
  • 浏览器访问：http://服务器IP/info.php，看到 PHP 信息页即成功（测试后建议删除该文件）。

二 两种常用集成方式

• 方式 A 模块方式 libapache2-mod-php（简单、适合单机）
  • 原理：Apache 以模块方式直接解析 .php。
  • 启用模块（如尚未启用）：sudo a2enmod phpX.Y（将 X.Y 替换为实际版本，如 8.1）
  • 确保索引文件包含 index.php：sudo nano /etc/apache2/mods-enabled/dir.conf，DirectoryIndex 行应包含 index.php
  • 重启生效：sudo systemctl restart apache2
  • 适用场景：快速部署、传统应用；并发与资源隔离能力弱于 FPM。
• 方式 B PHP-FPM + mod_proxy_fcgi（推荐、适合生产）
  • 安装 FPM：sudo apt install phpX.Y-fpm
  • 启动 FPM：sudo systemctl start phpX.Y-fpm && sudo systemctl enable phpX.Y-fpm
  • 启用代理模块：sudo a2enmod proxy_fcgi setenvif
  • 在站点配置中处理 PHP（示例为默认站点）：
    • 编辑：sudo nano /etc/apache2/sites-available/000-default.conf
    • 在 <VirtualHost *:80> 内加入： <FilesMatch .php$> SetHandler “proxy:unix:/run/php/phpX.Y-fpm.sock|fcgi://localhost”
  • 重启服务：sudo systemctl restart apache2 && sudo systemctl restart phpX.Y-fpm
  • 适用场景：多站点、高并发、与进程管理/OPcache 配合更佳。

三 常用配置与优化

• php.ini 位置与常用项（路径随版本与 SAPI 不同）：
  • 模块方式：/etc/php/X.Y/apache2/php.ini
  • FPM 方式：/etc/php/X.Y/fpm/php.ini
  • 常见调优（按需在 php.ini 中修改并重启服务）：
    • 开发环境：display_errors = On，error_reporting = E_ALL
    • 上传限制：upload_max_filesize = 50M，post_max_size = 50M
    • 性能：opcache.enable=1，opcache.memory_consumption=128
• 常用扩展（按需安装）：sudo apt install php-mysql php-gd php-curl php-xml php-mbstring php-zip php-bcmath
• 多站点与目录（示例）：
  • 新建配置：sudo nano /etc/apache2/sites-available/example.com.conf
  • 启用站点：sudo a2ensite example.com.conf && sudo systemctl reload apache2
  • 注意为目录设置合理的 AllowOverride 与 Require all granted。

四 故障排查与验证

• 服务状态与端口：
  • Apache：systemctl status apache2；端口：ss -tlnp | grep :80
  • FPM：systemctl status phpX.Y-fpm；套接字：ls -l /run/php/phpX.Y-fpm.sock
• 语法与配置检查：
  • Apache：sudo apache2ctl configtest
  • 重载：sudo systemctl reload apache2
• 日志定位：
  • Apache 错误日志：/var/log/apache2/error.log
  • FPM 日志：/var/log/phpX.Y-fpm.log（具体以 /etc/php/X.Y/fpm/php-fpm.conf 与 www.conf 为准）
• 常见问题速查：
  • 访问 .php 下载而非解析：确认已启用模块方式或已正确配置 FilesMatch + proxy_fcgi；检查是否加载了正确的 MimeType。
  • 502 Bad Gateway：多为 FPM 未启动或 socket 路径不一致；核对 /run/php/phpX.Y-fpm.sock 与 Apache 配置一致。
  • 扩展未生效：确认修改了对应 SAPI 的 php.ini（apache2 与 fpm 各一份），并重启对应服务。