根本原因是Alias路径不继承DocumentRoot的PHP处理器与执行权限，必须用<Directory>显式授权Require all granted并配合SetHandler或AddHandler绑定PHP处理，且需启用alias和php模块、确保目录权限正确。

Apache 2.4+ 下，PHP 8.1.25 的虚拟目录（Alias）默认不执行 PHP，只下载源码或报 403 —— 根本原因不是 PHP 版本或模块没装，而是 Alias 路径完全不继承主 DocumentRoot 的 PHP 处理器与执行权限，必须显式用 <directory></directory> 块授权并绑定 handler。

为什么 Alias 目录里 PHP 文件不解析，只弹下载？

Apache 对 Alias 映射的真实路径（比如 /var/www/shared/app）默认视为“静态资源区”，既没注册 PHP handler，也没放行执行权限。即使 mod_php 已加载、DocumentRoot 下的 PHP 正常工作，Alias 路径仍处于“无处理器 + 无访问许可”状态。

• 常见现象：访问 http://localhost/myapp/test.php，浏览器直接下载 test.php 源码；或返回 403 Forbidden，错误日志里出现 client denied by server configuration
• AddType application/x-httpd-php .php 单独加在 VirtualHost 顶层无效——它只影响主 DocumentRoot 及其子目录，不穿透到 Alias 真实路径
• .htaccess 在 Alias 目录下默认不生效，因为 AllowOverride 需在对应 <directory></directory> 块中显式开启，且 Alias 路径不自动触发该机制

<directory></directory> 必须包裹真实路径，且含 Require all granted 和 SetHandler

权限和处理器必须同时声明在 <directory></directory> 块内，路径必须和 Alias 指向的物理路径完全一致（注意大小写、末尾斜杠）。

• ✅ 正确写法（推荐）：

  <Alias /myapp "/var/www/shared/app">
  <Directory "/var/www/shared/app">
      Require all granted
      <FilesMatch \.php$>
          SetHandler application/x-httpd-php
      </FilesMatch>
  </Directory>

• ⚠️ 错误点：SetHandler 写在 <directory></directory> 顶层会强制所有文件（包括 .jpg、.js）走 PHP 解析器，导致图片无法显示、JS 报错
• ✅ 替代写法（按扩展名绑定）：

  <Directory "/var/www/shared/app">
      Require all granted
      AddHandler application/x-httpd-php .php
  </Directory>

• 若项目含 .phtml 或自定义后缀，优先用 SetHandler + FilesMatch，更可控

确保 alias 和 php 模块已启用，且路径权限到位

模块未启用或目录不可读，会导致配置静默失效。

PHP 8.5.12 RC 1

PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

立即学习“PHP免费学习笔记（深入）”；

• 确认模块加载：运行 sudo a2enmod alias php8.1（Debian/Ubuntu）或检查 /etc/httpd/conf.modules.d/ 下是否有对应 LoadModule 行（RHEL/CentOS）
• 真实路径必须存在且 Apache 进程可读：ls -ld /var/www/shared/app 应显示属主/属组为 www-data（或 apache），权限至少为 755
• SELinux 若启用，需放行 HTTP 访问：sudo setsebool -P httpd_read_user_content 1；AppArmor 用户检查 /etc/apparmor.d/usr.sbin.apache2 是否允许该路径
• 改完必须重启服务：sudo systemctl restart apache2（Debian）或 sudo systemctl restart httpd（RHEL）

别漏掉 hosts 绑定和端口监听

域名未解析或 Apache 没监听对应端口，请求根本进不到虚拟主机逻辑。

• 编辑 /etc/hosts，加一行：127.0.0.1 myapp.test（不要带 http:// 或空格）
• 若用了非标准端口（如 *:8000），必须在 /etc/apache2/ports.conf（Debian）或 /etc/httpd/conf/httpd.conf（RHEL）里显式添加：Listen 8000
• 全局 <directory></directory> 块（通常在主配置 210–230 行附近）若仍为 Require all denied，会覆盖子 <directory></directory> 设置——建议改为 Require local 或删掉该行，仅靠子块控制

最容易被忽略的是：Alias 的真实路径和 <directory></directory> 中写的路径必须字面完全一致，包括盘符大小写、斜杠方向、有无末尾斜杠；Apache 不做路径归一化，错一个字符就 403。