PHP怎么配置Apache虚拟主机_Apache+PHP多站点搭建指南【指南】-php教程-PHP中文网

apache vhost 中 php 不生效的主因是 php_module 未正确加载或版本不匹配，需检查模块加载状态、addhandler 位置、ts 版本适配、php_admin_value 用法、php-fpm 路径映射、namevirtualhost/listen 配置及权限问题。

php怎么配置apache虚拟主机_apache+php多站点搭建指南【指南】

Apache `vhost` 配置里 PHP 不生效？先确认模块是否真加载了

很多情况下你以为 PHP 已装好，phpinfo() 也能跑，但虚拟主机里却直接下载 .php 文件或返回 500 —— 根本原因常是 Apache 没真正启用 php_module，或者启用了错误版本（比如系统装了 PHP 8.2，但 Apache 加载的是旧版 libphp8.1.so）。

检查加载状态：httpd -M | grep php（Linux/macOS）或 apache2ctl -M | grep php；Windows 下看 httpd.conf 里是否有 LoadModule php_module 行，且路径指向当前 PHP 版本的 php8apache2_4.dll
确认 AddHandler 或 AddType 是否写在 <virtualhost></virtualhost> 内部，而不是只放在主配置里——外部设置不继承到 vhost
Windows 用户特别注意：如果用线程型 MPM（mpm_winnt），必须用 TS（Thread Safe）版 PHP，否则 LoadModule 会静默失败

多个站点共用一个 PHP 版本，但需要不同 `php.ini` 设置？用 `php_admin_value`

Apache 的 php_value 在 vhost 中会被忽略（尤其 PHP-FPM 模式下），而 php_admin_value 才是能强制覆盖全局配置的正确方式，且不会被用户脚本的 ini_set() 绕过。

只能在 <virtualhost></virtualhost> 或 <directory></directory> 块中使用，不能写在 .htaccess
常见用途：php_admin_value open_basedir "/var/www/site-a:/tmp"、php_admin_flag display_errors on
注意权限：某些指令（如 memory_limit）允许被 php_admin_value 修改，但 disable_functions 等安全相关项可能被编译时锁定，改了也无效

PHP-FPM 模式下 `DocumentRoot` 和 `SCRIPT_FILENAME` 对不上？这是 FastCGI 参数映射错了

用 ProxyPassMatch 转发 PHP 请求时，如果浏览器访问 http://site-a.test/index.php 却报 File not found，大概率是 SCRIPT_FILENAME 环境变量拼错了路径，导致 PHP-FPM 去找不存在的文件。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

典型错误配置：ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/ —— 结尾斜杠会让 PHP-FPM 把请求当成根目录下执行，实际文件却在 /var/www/site-a
正确写法（推荐）：ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/site-a/，确保后端路径与 DocumentRoot 一致
更健壮的做法：用 SetHandler "proxy:fcgi://127.0.0.1:9000" + ProxyFCGISetEnvIf 动态设置 SCRIPT_FILENAME，避免硬编码路径

本地开发用 `localhost` 子域名，`/etc/hosts` 配了但浏览器打不开？别漏掉 Apache 的 `NameVirtualHost` 或监听配置

哪怕 vhost 写得再对，如果 Apache 根本没监听对应 IP:端口，或没启用基于名称的虚拟主机，所有请求都会落到默认站点。

Apache 2.4+ 不再需要 NameVirtualHost 指令，但必须确保 Listen 80（或对应端口）存在，且 <virtualhost></virtualhost> 中的 * 与监听地址匹配（比如监听了 127.0.0.1:80，就不能写 <virtualhost></virtualhost>）
/etc/hosts 里加了 127.0.0.1 site-a.test，但浏览器仍连到默认站，用 curl -H "Host: site-a.test" http://127.0.0.1 测试 —— 如果这时能返回正确内容，说明是 DNS 或浏览器缓存问题，不是 Apache 配置问题
Mac 用户注意：sudo apachectl configtest 有时不报错，但实际加载失败，建议用 sudo apachectl -t -D DUMP_VHOSTS 直接看 Apache 解析出的 vhost 列表

最常卡住人的地方其实是 PHP-FPM 的 socket 权限和 Apache 用户组不一致，或者 DocumentRoot 目录权限没放开读取——这些不会报明显错误，只会让页面空白或 403。调的时候别只盯着配置文件，先看 error_log 里有没有 Permission denied 或 connect() to unix: 类提示。