phpEnv无官方批量添加站点功能，所有批量操作需手动编辑httpd-vhosts.conf或用PowerShell等脚本生成VirtualHost配置块，并同步修改hosts文件、验证语法后重启Apache。
phpEnv 没有官方批量添加站点功能，所有“批量”操作都依赖手动编辑配置文件或脚本辅助，硬套界面点击或一键按钮会失败。
phpEnv 的站点配置本质是 Apache httpd-vhosts.conf 文件的重复块
phpEnv 并非图形化管理工具（如 phpStudy 或 Laragon），它只是轻量级封装，核心仍为原始 Apache + PHP + MySQL。每个站点对应一个 <virtualhost></virtualhost> 块，写在 Apache/conf/extra/httpd-vhosts.conf 中。
- 路径示例：
C:\phpenv\Apache\conf\extra\httpd-vhosts.conf - 每加一个站，就得手写一个
<virtualhost></virtualhost>块，含ServerName、DocumentRoot、<directory></directory>权限三要素 - 不支持通配符域名或动态 root（比如
DocumentRoot "C:/www/${HOST}"），Apache 本身就不允许变量插值 - 若已有 5 个站，新增第 6 个，必须复制粘贴前一块、改名、改路径、检查引号和斜杠方向（Windows 下路径用正斜杠
/更安全）
用 PowerShell 批量生成 httpd-vhosts.conf 片段（Windows 推荐）
与其反复手敲，不如写个 10 行脚本把站点列表转成配置块。以下命令可直接在 PowerShell 中运行（保存为 gen-vhost.ps1）：
$projects = @(
@{ name = "site-a.test"; path = "C:/www/site-a" },
@{ name = "site-b.test"; path = "C:/www/site-b" },
@{ name = "api.local"; path = "C:/www/api" }
)
foreach ($p in $projects) {
@"
<VirtualHost *:80>
ServerName $($p.name)
DocumentRoot "$($p.path)"
<Directory "$($p.path)">
Require all granted
AllowOverride All
</Directory>
</VirtualHost>
<p>"@ | Out-File -Append -Encoding UTF8 "C:\phpenv\Apache\conf\extra\httpd-vhosts.conf"
}</p>- 执行前先备份原
httpd-vhosts.conf，避免覆盖已有配置 - 脚本末尾空行不能少，否则多个
会连在一起，Apache 启动报错Syntax error on line X - 路径中不要用中文或空格；若必须用，
DocumentRoot和<directory></directory>的值需用双引号包裹 - 生成后必须手动执行
httpd -t验证语法，再重启 Apache
hosts 文件也得同步批量处理，别只改 Apache
只配了 httpd-vhosts.conf 但没改系统 hosts，浏览器根本解析不到本地——这是最常被跳过的一步。
立即学习“PHP免费学习笔记（深入）”；
- Windows
hosts路径：C:\Windows\System32\drivers\etc\hosts - macOS/Linux：
/etc/hosts - 必须用管理员权限（Windows）或
sudo（macOS/Linux）保存，否则写入失败但无提示 - 批量追加示例（PowerShell）：
"127.0.0.1 site-a.test`n127.0.0.1 site-b.test" | Out-File -Append -Encoding ASCII C:\Windows\System32\drivers\etc\hosts - 注意：hosts 中不能有空行、注释行不能以
#开头后带空格（部分旧版解析器会卡住）
为什么不用 phpStudy/Laragon？phpEnv 的真实约束在哪
phpEnv 的定位是“极简可控”，不是“开箱即用”。它省掉了 GUI 层，但也意味着：
- 没有站点开关按钮——停用某个站，得手动注释掉对应
<virtualhost></virtualhost>块（加#不管用，必须用<!-- -->或整块删） - 不自动生成 SSL 配置——要 HTTPS，得自己补
SSLEngine on、SSLCertificateFile等 6 行以上配置 - 多 PHP 版本共存时，
httpd-vhosts.conf里无法按站点指定 PHP-FPM socket；只能全局切版本，或靠SetHandler+ProxyPassMatch手动路由（极易配错） - 每次更新 phpEnv，
httpd-vhosts.conf可能被重置——你加的站点配置就丢了，必须从备份恢复
真正需要批量管理的场景，建议直接换 Laragon（右键 → Create Virtual Host）或小皮面板（Web 界面点选），phpEnv 只适合明确知道自己在改哪几行配置的人。
