phpStudy搭建多站点PHP独立运行环境流程-php教程-PHP中文网

phpstudy多站点配置必须启用httpd-vhosts.conf，否则仅认默认documentroot；需取消httpd.conf中#include conf/extra/httpd-vhosts.conf的注释，重启apache，并确保servername、hosts映射与目录权限三者严格一致。

phpstudy搭建多站点php独立运行环境流程

phpStudy 多站点必须启用虚拟主机配置

不开启 httpd-vhosts.conf，哪怕你在面板里加了十个站点，Apache 也只会认默认的 DocumentRoot（通常是 D:/phpStudy/WWW），其余站点完全不生效。

关键操作是打开 D:\phpStudy\PHPTutorial\Apache\conf\httpd.conf，找到这行：

#Include conf/extra/httpd-vhosts.conf

删掉开头的 #，保存。这一步漏掉，后面所有配置都白做。

Windows 路径注意反斜杠转义或直接用正斜杠（D:/www/site1 更安全）
如果用小皮面板 v8.x，界面里“网站”→“添加网站”会自动写入配置并启用该文件，但老版本或手动修改后仍需确认此开关是否打开
改完 httpd.conf 必须重启 Apache，仅点“重新加载配置”不够

每个站点要绑定唯一域名 + 独立目录 + 显式端口

多站点不是靠目录区分，而是靠 ServerName 和监听端口共同决定请求路由。同一端口下不能有两个 ServerName 相同的 <virtualhost></virtualhost> 块，否则后加载的会覆盖前一个。

典型正确配置（httpd-vhosts.conf 中）：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

<virtualhost>
    DocumentRoot "D:/www/admin"
    ServerName admin.local
    <directory>
        Require all granted
        AllowOverride All
    </directory></virtualhost><p><virtualhost>
DocumentRoot "D:/www/api"
ServerName api.local
<directory>
Require all granted
AllowOverride All
</directory></virtualhost></p>

ServerName 必须和 hosts 文件里写的完全一致（区分大小写、无空格）
若想用不同端口（如 :8080），除了在 <virtualhost></virtualhost> 中写明，还必须在 httpd.conf 里加 Listen 8080
目录路径不要带中文或空格，否则 Apache 可能拒绝启动

hosts 文件必须手动追加映射，且不能有重复 IP 行

Windows 的 C:\Windows\System32\drivers\etc\hosts 是唯一能让浏览器把 admin.local 解析到 127.0.0.1 的地方。phpStudy 面板里的“打开 hosts”按钮只是快捷方式，实际编辑仍需管理员权限保存。

常见错误写法：

# 错误：同一 IP 多次出现，系统只认第一个
127.0.0.1 admin.local
127.0.0.1 api.local
127.0.0.1 admin.local  ← 这行会导致前面那行失效

每行只能有一个域名，多个域名需分行写
行首不能有空格，末尾不能有多余空格或不可见字符（建议用 Notepad++ 或 VS Code 编辑）
改完 hosts 后，CMD 执行 ipconfig /flushdns，否则 DNS 缓存可能让新域名无法解析

PHP 版本必须按站点单独指定，不能全局混用

ThinkPHP8 多应用、Laravel 11、WordPress 6.8 对 PHP 版本要求差异极大。phpStudy 小皮面板支持 per-site PHP 切换，但这个设置只对 Apache 模块模式（php_module）生效；若你启用了 FastCGI（Nginx 或 Apache 的 mod_fcgid），该设置会被忽略，必须改 httpd-vhosts.conf 里对应站点的 SetHandler 或使用 ProxyPass 转发到指定 PHP-FPM 端口。

面板中“网站”→选中站点→“设置”→“PHP版本”下拉选择，适用于绝大多数 Apache + mod_php 场景
如果站点报错 PHP Parse error: syntax error, unexpected token "="，大概率是用了 PHP 8.0+ 语法但实际运行在 PHP 7.4
检查当前生效版本最可靠方式：在站点根目录放一个 info.php，内容为 <?php phpinfo(); ?>，访问看顶部显示的版本号

配置真正跑通的关键不在步骤数量，而在三处必须同步：httpd-vhosts.conf 里的 ServerName、hosts 文件里的对应行、以及每个站点目录下能正常响应的脚本（比如 index.php 输出 phpversion()）。少一处，就卡在 404 或 500。