Apache 中 Alias 仅映射路径，不自动授权或解析 PHP；必须配匹配的 <Directory> 块（含 Require all granted）并用 <FilesMatch \.php$> 显式设置 SetHandler，同时处理 SELinux 上下文与文件权限。
PHP 8.1 在 CentOS 上配 Apache 虚拟目录（即 Alias 或 AliasMatch），不是配虚拟主机（VirtualHost），核心目标是：让某个 URL 路径（如 /api）指向项目外的物理目录（如 /opt/myapi），且该目录下 PHP 文件能正常执行。
为什么用 Alias 而不是 DocumentRoot？
因为虚拟目录是“嵌入式”的——它不替代整个站点根目录，而是挂载在现有站点路径下。比如主站跑在 /var/www/html，但你想把 https://example.com/admin 指向 /opt/admin-tool，这时不能改 DocumentRoot，得用 Alias。
常见错误现象：
- 访问
/admin返回 404，但路径真实存在 - PHP 文件被下载（而不是执行），浏览器弹出保存对话框
- 报错
Forbidden，提示“You don't have permission to access this resource”
根本原因不是 PHP 版本问题（PHP 8.1 的命名参数报错和这个无关），而是 Apache 没给别名路径授权或没启用 PHP 解析。
立即学习“PHP免费学习笔记（深入）”；
Alias + PHP 执行必须配 Directory 块
Alias 只做路径映射，不继承父目录权限。Apache 2.4+ 默认禁止所有未显式授权的路径，所以必须紧跟着写一个匹配的 <Directory> 块。
实操建议：
- 确保
Alias和<Directory>的路径完全一致（注意末尾斜杠：两者都不要加，或都加） -
<Directory>内必须包含Require all granted（Apache 2.4+ 语法） - 如果要用
.htaccess（比如 Laravel 的重写规则），还得加AllowOverride All - 路径中含空格或中文？用引号包裹，例如
<Directory "/opt/my api">
示例配置（加到 /etc/httpd/conf.d/myapp.conf 或主配置里）：
Alias /admin "/opt/admin-tool"
<Directory "/opt/admin-tool">
Require all granted
AllowOverride All
Options FollowSymLinks
</Directory>
怎么让 Alias 下的 .php 文件可执行？
Apache 不会自动把 Alias 路径下的 PHP 文件交给 PHP 引擎处理——它只认 DocumentRoot 下的解析规则。所以你得手动告诉 Apache：“这个目录里的 .php，也按 PHP 方式处理”。
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
关键点：
- 不能只靠全局的
AddType application/x-httpd-php .php，它只影响 MIME 类型，不触发处理器 - 必须用
<FilesMatch>或<Location>显式绑定处理器 - PHP 8.1 + mod_php 方式：用
SetHandler；若用 PHP-FPM（推荐），则用SetHandler "proxy:fcgi://127.0.0.1:9000"
完整示例（mod_php）：
Alias /admin "/opt/admin-tool"
<Directory "/opt/admin-tool">
Require all granted
AllowOverride All
Options FollowSymLinks
</Directory>
<FilesMatch \.php$>
SetHandler application/x-httpd-php
</FilesMatch>
若用 PHP-FPM（更安全、支持多版本）：
<FilesMatch \.php$>
SetHandler "proxy:fcgi://127.0.0.1:9000"
</FilesMatch>
注意：fastcgi_pass 地址必须和 php-fpm 实际监听地址一致（查 /etc/php-fpm.d/www.conf 的 listen 行）。
SELinux 和文件权限最容易被忽略
CentOS 默认开启 SELinux，它会拦截 Apache（运行用户为 apache）对非标准路径（如 /opt/）的读取和执行。
验证是否 SELinux 导致失败：
- 临时关闭测试：
sudo setenforce 0，再访问；若好了，就是 SELinux 问题 - 永久解决：给目标目录打上正确上下文：
sudo semanage fcontext -a -t httpd_sys_content_t "/opt/admin-tool(/.*)?"，然后sudo restorecon -Rv /opt/admin-tool - 如果目录里要写日志或上传文件，还需加
httpd_sys_rw_content_t
另外检查文件权限：
-
ls -ld /opt/admin-tool→ 目录至少需rx权限给apache用户或组 -
ls -l /opt/admin-tool/index.php→ 文件需r权限 - 避免用
chmod 777，最小权限原则
改完配置后必须重启服务：sudo systemctl restart httpd，不是 reload。
