PHP 8.1本身不提供虚拟主机功能，虚拟主机由Web服务器（Apache或Nginx）配置，PHP仅作为解释器通过模块或PHP-FPM被调用；Apache需启用php8.1模块、添加AddType/AddHandler指令并验证语法，Nginx需正确配置fastcgi_pass指向PHP-FPM监听地址及SCRIPT_FILENAME参数。
PHP 8.1 本身不提供虚拟主机功能，它只是解释器；虚拟主机由 Web 服务器（Nginx 或 Apache）配置，再通过 PHP-FPM 或模块方式调用 PHP 8.1。关键不是“PHP 配置虚拟主机”，而是「让 Web 服务器把请求正确交给 PHP 8.1 处理」。
Apache：启用 php8.1 模块并确认 Handler 生效
Apache 必须显式加载 libphp8.1.so 并声明如何处理 .php 文件，否则会直接下载或返回源码。
- 先确认模块存在：
ls /usr/lib/apache2/modules/libphp8.1.so（Ubuntu/Debian）或find /usr -name "libphp8.1.so" 2>/dev/null（RHEL 系列） - 启用模块：
sudo a2enmod php8.1—— 注意不是php或rewrite - 检查虚拟主机配置中是否包含这两行（必须在
<VirtualHost>内）：AddType application/x-httpd-php .phpAddHandler application/x-httpd-php .php - 重启前务必验证语法：
sudo apache2ctl configtest，避免因拼写错误（如AddHander）导致服务启动失败 - 若仍报 500 或空白页，用
apache2ctl -M | grep php确认php_module (shared)是否在输出中
Nginx：fastcgi_pass 必须指向正确的 PHP-FPM sock 或端口
Nginx 不内置 PHP 解析能力，全靠 fastcgi_pass 转发给 PHP-FPM 进程。配错路径或端口，页面就 502。
- 确认 PHP-FPM 服务已运行：
sudo systemctl status php8.1-fpm（Ubuntu/Debian）或systemctl status php-fpm-81（CentOS/Rocky） - 查实际 sock 路径：
sudo ss -tulpn | grep ':9000\|php'，常见路径有：unix:/run/php/php8.1-fpm.sock（Debian/Ubuntu）unix:/var/opt/remi/php81/run/php-fpm/www.sock（CentOS + Remi） - 在
location ~ \.php$块中，只保留一个fastcgi_pass：
✅ 正确：fastcgi_pass unix:/run/php/php8.1-fpm.sock;
❌ 错误：fastcgi_pass 127.0.0.1:9000;（若 PHP-FPM 没监听 TCP） -
fastcgi_param SCRIPT_FILENAME必须用$document_root$fastcgi_script_name，不能硬编码路径
宝塔/Oneinstack/群晖等环境：别信界面显示的“已选 PHP 8.1”
这些面板常把 Web 运行时和 CLI 环境分开管理，点选了 PHP 版本 ≠ 项目真能用上所有扩展。
立即学习“PHP免费学习笔记（深入）”；
- 上传
test.php内容为<?php phpinfo(); ?>，访问后重点核对三处：
–PHP Version显示8.1.x
–Loaded Configuration File路径是否指向你认为的那个php.ini（如/www/server/php/81/etc/php.ini）
–Registered PHP Streams是否含https, http（缺则file_get_contents('https://...')失败） - 群晖用户尤其注意：
php -v和 Web 页面的phpinfo()可能完全不同版本，必须用 Web Station 中显示的完整路径（如/volume1/@appstore/PHP81/usr/bin/php）来验证 CLI - 宝塔里启用
fileinfo后仍报Call to undefined function finfo_open()？重启对应 PHP 版本服务，不是只点“重载配置”
最常被忽略的一点：DocumentRoot 或运行目录设错，比如 Laravel/ThinkPHP 项目没把 Nginx 的 root 指向 /public，而是整个项目根目录，会导致路由、静态资源全部 404，且错误日志里根本不会提 PHP 版本问题。
