Apache配PHP虚拟目录本质是Alias映射、Directory权限放行（Require all granted）与PHP解析器绑定（AddHandler或SetHandler）三者联动，缺一不可。
Apache 里配 PHP 虚拟目录，本质不是 PHP 的事，而是 Apache 的 Alias + Directory 权限 + PHP 解析器联动的问题。直接改 httpd.conf 或 sites-available 里的配置就能生效，不需要动 PHP 配置文件。
Alias 指令必须配合 Directory 块才有效
只写 Alias /api /var/www/myapp/api 不会自动赋予访问权限，Apache 2.4+ 默认拒绝所有未显式授权的路径。
-
Alias只负责 URL 到物理路径的映射，不等于“可访问” - 必须紧跟着一个同路径的
<Directory "/var/www/myapp/api">块 - 里面至少要包含
Require all granted（Apache 2.4）或Order allow,deny && Allow from all（2.2，已淘汰） - 如果该目录下有
.htaccess且需支持重写（如 Laravel API 路由），还得加AllowOverride All
PHP 文件在虚拟目录里不执行，只下载？检查 AddHandler 或 SetHandler
Apache 默认不把 .php 当脚本执行——尤其是通过 Alias 引入的路径，AddType 不起作用，必须用 AddHandler 或 SetHandler 显式绑定。
- 在
<Directory>块内加：AddHandler application/x-httpd-php .php - 或更精确地（推荐）：
<FilesMatch "\.php$">SetHandler "proxy:fcgi://127.0.0.1:9001"</FilesMatch>（对接 php-fpm） - 别漏掉
ProxySet timeout=300，否则大文件上传或慢脚本会超时断连 - 如果用 mod_php（不推荐生产），确认
LoadModule php_module modules/libphp.so已启用，且版本匹配 PHP 8.4.15
Ubuntu 下配置位置和启用顺序不能错
Ubuntu 的 Apache 配置结构是分层的：sites-available 是源文件，sites-enabled 是符号链接集合；改完不启用 = 白改。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
- 配置文件建议放
/etc/apache2/sites-available/myapp.conf，不要直接改000-default.conf - 启用命令必须是：
sudo a2ensite myapp.conf（不是cp到 enabled 目录） - 改完后务必运行：
sudo apache2ctl -t验证语法，再sudo systemctl reload apache2 - 如果用了
Alias，注意它不能出现在<VirtualHost>外部，否则会被忽略
PHP 8.4.15 特别要注意 fastcgi_param SCRIPT_FILENAME
用 php-fpm 时，如果虚拟目录里 PHP 脚本报 “No input file specified”，99% 是 SCRIPT_FILENAME 拼错了——$document_root 在 Alias 场景下不指向真实路径。
- 正确写法（在
<Directory>或<Location>内）：fastcgi_param SCRIPT_FILENAME /var/www/myapp/api$fastcgi_script_name - 绝对不要依赖
$document_root，它只反映DocumentRoot，跟Alias无关 - PHP-FPM pool 的
chdir设置也会影响相对路径解析，建议设为空或明确指定 - 调试技巧：在 PHP 脚本开头加
var_dump($_SERVER['SCRIPT_FILENAME']);看实际传入的是什么
最常被跳过的一步：改完 hosts 后没清浏览器 DNS 缓存，或者用 curl -H "Host: example.com" http://127.0.0.1/api/test.php 测试时忘了带 -H，结果一直走默认主机。虚拟目录是否生效，得靠请求头 Host 和路径双重匹配，少一个都落空。
