phpEnv配置Vhost虚拟主机高级教程-php教程-PHP中文网

phpenv配置虚拟主机需四步：一、取消httpd.conf中include conf/extra/httpd-vhosts.conf的注释；二、确保documentroot路径用正斜杠、无中文空格、指向public目录；三、directory块内必须含options indexes followsymlinks、allowoverride all、require all granted；四、启用loglevel debug查error.log定位500/403错误。

phpenv配置vhost虚拟主机高级教程

phpEnv 是一个 Windows 下轻量级的 PHP 集成环境（类似 XAMPP、WAMP），但默认不带图形界面，配置虚拟主机必须手动编辑 Apache/Nginx 配置文件 + 修改 hosts。它不自动启用 httpd-vhosts.conf，也不预设 PHP-FPM 代理规则，直接照搬其他环境的配置大概率 500 或 403。

phpEnv 的 Apache 虚拟主机必须显式启用 vhosts 文件

phpEnv 默认的 httpd.conf 中，Include conf/extra/httpd-vhosts.conf 这行是被注释掉的 —— 这意味着你往 httpd-vhosts.conf 里写再多配置也无效。不检查这一步，所有后续操作都是白忙。

打开 phpEnv\apache\conf\httpd.conf，搜索 httpd-vhosts.conf
去掉该行开头的 #，确保变成：Include conf/extra/httpd-vhosts.conf
保存后必须重启 Apache（不是重载，是完整 stop → start）
验证是否生效：访问 http://localhost 应仍正常；若出现 403 或空白页，说明 DocumentRoot 权限或路径写错，不是 vhosts 没启用

DocumentRoot 路径必须用正斜杠且不能有中文或空格

phpEnv 基于较老版本 Apache（常为 2.4.x），对 Windows 路径解析敏感。DocumentRoot "D:\my project\public" 或 DocumentRoot "D:\my project\public" 都会触发 Invalid command 'DocumentRoot' 错误或 403 Forbidden。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

路径中禁止出现中文、空格、括号（如 (dev)）
必须使用正斜杠：DocumentRoot "D:/my_project/public"
路径末尾不要加斜杠，也不要指向父目录（比如 D:/my_project 而非 D:/my_project/public）—— 否则 .htaccess 重写可能失效
确认该路径下存在 index.php 或 index.html，否则 Apache 会返回 403（因默认禁列目录）

Directory 权限块必须包含 `Require all granted` 且位置正确

Apache 2.4+ 彻底弃用 Order allow,deny 和 Allow from all，但 phpEnv 自带的默认 <directory></directory> 块往往还保留旧语法。如果沿用旧写法，服务启动失败或返回 403。

每个 <virtualhost></virtualhost> 内的 <directory></directory> 必须写全以下三行：
Options Indexes FollowSymLinks
AllowOverride All（Laravel、ThinkPHP 等框架依赖此支持重写）
Require all granted（唯一有效的放行指令，Require all denied 才是拒绝）
注意：<directory></directory> 的路径必须和 DocumentRoot 完全一致，包括大小写和结尾斜杠（都不加）

PHP 解析在 phpEnv 中默认走 mod_php，不推荐改 FPM

phpEnv 默认把 PHP 编译为 Apache 模块（LoadModule php_module），而非通过 fastcgi_pass 转发给 PHP-FPM。强行在 VirtualHost 里加 SetHandler "proxy:fcgi://127.0.0.1:9000" 会导致 503 Service Unavailable，因为 phpEnv 默认不运行 PHP-FPM 服务。

保持默认即可：确保 httpd.conf 中已加载 php_module，且有 AddType application/x-httpd-php .php
若需 FPM（比如调试内存限制），得手动启动 php-cgi.exe -b 127.0.0.1:9000，并确认端口未被占用
测试 PHP 是否工作：在站点根目录放一个 info.php，内容为 <?php phpinfo(); ?>，访问 http://yourdomain.test/info.php 看是否输出

最易被忽略的是：phpEnv 的 Apache 日志默认关闭详细错误（LogLevel warn），遇到 500 只显示“Internal Server Error”。务必先在 httpd.conf 中改成 LogLevel debug 并查 logs/error.log，否则你永远不知道是路径错、权限错，还是某行少了个引号。