Apache 的 vhost 机制实现多站点，PHP 8.4 仅作为模块被调用；需正确配置 ServerName、DocumentRoot、PHP 指令隔离及监听端口，并验证模块加载与配置语法。
PHP 8.4 本身不负责多站点配置，真正起作用的是 Apache 的 vhost 机制；PHP 只是作为模块或 CGI 处理器被调用。所以问题本质是：如何在启用 PHP 8.4 的 Apache 环境中正确配置多个基于域名/端口的虚拟主机。
确认 PHP 8.4 已以模块方式加载（非 CGI/FPM）
Apache 多站点依赖 mod_php（即 libphp.so）时，所有 vhost 共享同一套 PHP 配置；若用 PHP-FPM，则需为每个站点配独立 php-fpm pool。多数新手误以为“装了 PHP 8.4 就自动支持多站”，其实第一步必须验证 Apache 正确加载了 PHP 模块：
- 运行
httpd -M | grep php或apache2ctl -M | grep php，应看到php_module (shared) - 检查
httpd.conf或mods-enabled/php8.4.load是否存在且未被注释 - 若使用
php-fpm，LoadModule proxy_fcgi_module和SetHandler "proxy:fcgi://127.0.0.1:9000"必须出现在每个<VirtualHost>内，而非全局
每个 VirtualHost 必须显式声明 DocumentRoot 和 ServerName
Apache 不会自动按目录名或子文件夹推断站点；漏写 ServerName 或 DocumentRoot 是 80% 多站点失效的根源。尤其注意：
-
ServerName必须是完整域名（如site1.local），不能是路径或 IP（127.0.0.1/site1无效） -
DocumentRoot路径末尾不加斜杠（/var/www/site1✅，/var/www/site1/❌ 可能触发 403） - 本地测试需同步修改
/etc/hosts，例如添加127.0.0.1 site1.local site2.local
<VirtualHost *:80>
ServerName site1.local
DocumentRoot "/var/www/site1"
<Directory "/var/www/site1">
Require all granted
AllowOverride All
</Directory>
</VirtualHost>
PHP 8.4 特定配置需按站点隔离（关键！）
PHP 8.4 引入了更严格的默认配置（如 opcache.enable_cli=0、zend.assertions=0），但这些是全局生效的。若两个站点需要不同 error_reporting 或 upload_max_filesize，不能靠 php.ini 统一设——必须用 Apache 指令逐站覆盖：
立即学习“PHP免费学习笔记（深入）”；
- 在对应
<VirtualHost>内使用php_flag（布尔值）或php_value（字符串/数值），例如：php_value upload_max_filesize "64M" - PHP 8.4 已废弃
php_admin_flag/value在 .htaccess 中使用，仅允许在主配置或<VirtualHost>中设置 - 避免在
.htaccess里写 PHP 指令，Apache 会直接 500 报错：“Invalid command 'php_value'”
重启后仍 404？优先检查 Apache 的 Listen 和 NameVirtualHost（常见陷阱）
Apache 2.4+ 默认只监听 *:80，但若你改过端口（比如用 :8080），却忘了在 httpd.conf 里加 Listen 8080，所有请求根本进不来。另外：
-
NameVirtualHost *:80在 2.4+ 已废弃，删掉它，否则启动报错 - 确保
Include语句已加载你的站点配置文件（如Include /etc/apache2/sites-enabled/*.conf） - 运行
apachectl configtest，输出 “Syntax OK” 才代表配置无硬错误
最常被忽略的一点：PHP 8.4 的 opcache.preload 若指向全局文件，可能因路径权限或 autoloader 冲突导致某个站点白屏而其他正常——这时要单独为每个站点禁用 preload：php_flag opcache.preload 0。
