PHP8.0虚拟目录重启服务器生效规则-php教程-PHP中文网

php 8.0 下修改虚拟主机配置后，必须重启对应web服务器及php处理器：apache+mod_php需重启apache2；nginx+php-fpm须同时reload nginx和php8.0-fpm；宝塔等集成环境还需单独重载php服务，否则因进程隔离或缓存导致路径错位、autoload失败、页面空白。

php8.0虚拟目录重启服务器生效规则

PHP 8.0 中 virtual host 配置修改后必须重启哪些服务

改完 Apache 或 Nginx 的虚拟主机配置，只 reload 不够，PHP 8.0 环境下常因缓存或进程隔离导致新配置不生效。关键要看 Web 服务器和 PHP 处理器是否真正加载了新路径与参数。

常见错误是只执行 nginx -s reload 或 systemctl reload apache2，却漏掉 PHP-FPM 进程的重载——尤其当 php.ini 或 FPM pool 配置（如 www.conf 中的 chdir、php_admin_value[doc_root]）被调整时，旧 worker 进程仍按老路径解析 index.php，结果就是路由错位、autoload 失败、页面空白。

Apache + mod_php：只需重启 apache2（或 httpd），PHP 配置随 Apache 主进程加载
Nginx + PHP-FPM：必须同时执行 systemctl reload php8.0-fpm（或对应版本如 php8.0-fpm）和 nginx -s reload
宝塔/PhpStudy 等集成环境：界面点“重载配置”通常只刷 Nginx/Apache，需额外进“PHP 设置”页点“重载服务”或手动执行 service php-fpm restart

DocumentRoot 指向 public/ 后，Nginx 的 root 和 fastcgi_param 必须同步修正

ThinkPHP 8.0 要求 Web 服务器的根目录严格指向 public/，否则 vendor/autoload.php 加载失败，报 Fatal error: Class 'think\App' not found 且静默白屏。但仅改 root 不够，fastcgi_param SCRIPT_FILENAME 的拼接逻辑会因 $document_root 变化而失效。

典型错误配置：

root /var/www/myapp;
location ~ \.php$ {
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

此时 $document_root 是 /var/www/myapp，而实际 index.php 在 /var/www/myapp/public/index.php，导致 FastCGI 报 Primary script unknown。

正确写法（两处必须一致）：

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

root /var/www/myapp/public;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;（此时 $document_root 已含 public/）

Apache 的 DocumentRoot 修改后，.htaccess 重写规则可能被忽略

Apache 默认禁止 .htaccess 覆盖行为，即使你把 DocumentRoot 改对了，若没开 AllowOverride All，ThinkPHP 的 URL 重写（如隐藏 index.php）就无效，访问 /user 会 404，而非转发到 index.php。

检查 <directory></directory> 块是否包含：

<directory>
    AllowOverride All
    Require all granted
</directory>

注意：AllowOverride None 是默认值，不显式写 All 就等于关掉重写支持；另外，mod_rewrite 必须已启用（a2enmod rewrite），否则 .htaccess 再全也没用。

PHP-FPM 的 chdir 配置会覆盖 Nginx 的 root，优先级更高

当 PHP-FPM pool 配置（如 /etc/php/8.0/fpm/pool.d/www.conf）中设置了 chdir = /var/www/myapp，它会强制所有 PHP 脚本以该路径为工作目录启动——哪怕 Nginx 的 root 指向 public/，require 'vendor/autoload.php' 也会从 /var/www/myapp/vendor/autoload.php 去找，而不是 /var/www/myapp/public/vendor/autoload.php，直接失败。

解决方案只有两个：