phpEnv如何运行Yii2框架 phpEnv部署Yii2高级版环境-php教程-PHP中文网

phpEnv不支持Yii2高级版开箱即用，因其仅配单入口，而高级版需frontend/web和backend/web两个独立入口；必须调整目录结构、修改index.php路径、精准配置open_basedir并补全Web服务器try_files规则。

phpenv如何运行yii2框架 phpenv部署yii2高级版环境

phpEnv 本身不直接支持 Yii2 高级版的开箱即用部署，核心问题在于它默认只配单入口、单 Web 根目录，而 Yii2 高级版必须区分 frontend/web 和 backend/web 两个独立入口点——不调整结构或重写路由，后台永远 404 或报 open_basedir 错误。

phpEnv 下必须改掉 frontend/web 和 backend/web 的物理路径

phpEnv 的站点根目录（如 C:\phpEnv\www\myapp）只能指向一个 index.php。Yii2 高级版却要求：前端走 /web/index.php，后台走 /backend/web/index.php。硬套会导致后台请求被 phpEnv 当作静态路径拦截，或触发 require(): open_basedir restriction in effect。

正确做法是把 frontend/web 内容整体复制到 phpEnv 的站点根目录（如 C:\phpEnv\www\myapp），并修改其 index.php 中的 $appConfig 路径，指向 ../environments/prod/frontend/web.php（非开发环境时）
再新建子目录 C:\phpEnv\www\myapp\admin，把 backend/web 全部内容移入，并同步修改该目录下 index.php 的 $appConfig 指向 ../environments/prod/backend/web.php
关键检查点：两个 index.php 中的 require __DIR__.'/../../vendor/autoload.php' 必须能真实定位到 vendor，路径不能因移动而断裂

php.ini 必须关闭 open_basedir 或精准放行

phpEnv 默认开启 open_basedir，且值常为 C:\phpEnv\www\。一旦你把 backend/web 移到 \admin 子目录，index.php 就会尝试加载 ../../vendor/autoload.php，而该路径已超出 open_basedir 范围，直接报错：

Warning: require(): open_basedir restriction in effect. File(C:\phpEnv\www\myapp\vendor\autoload.php) is not within the allowed path(s)

临时方案：在 phpEnv 控制面板中找到当前 PHP 版本 → “PHP 配置” → 找到 open_basedir，清空其值（仅限本地开发）
稳妥方案：设为 C:\phpEnv\www\myapp\;C:\phpEnv\www\myapp\admin\;C:\phpEnv\www\myapp\runtime\;C:\phpEnv\www\myapp\assets\，注意末尾加反斜杠、用分号分隔
别漏掉 runtime 和 assets 目录，否则日志写不进、资源生成失败

nginx.conf 或 apache.conf 里要手动补全 try_files 规则

phpEnv 自带的 Nginx/Apache 配置模板只照顾单应用，对 Yii2 高级版的多入口无感知。若不干预，访问 /admin/ 会 404，因为请求根本没被转发给 admin/index.php。

btpanel phpsite 宝塔面板PHP网站

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

下载

若用 Nginx：在站点配置的 location / 块内，确保有 try_files $uri $uri/ /index.php?$args;；同时为 /admin/ 单独加一段：

location /admin/ {
    alias C:/phpEnv/www/myapp/admin/;
    try_files $uri $uri/ /admin/index.php?$args;
}

若用 Apache：确认 .htaccess 已启用，且 frontend/web/.htaccess 和 admin/.htaccess 都存在且内容正确（含 RewriteRule ^(.*)$ index.php?r=$1 [QSA,L]）
Windows 下 Apache 的 DocumentRoot 必须用正斜杠或双反斜杠，单反斜杠会解析失败

init 和 migrate 必须在命令行里跑，不能靠浏览器

phpEnv 提供的“Web 环境”只是运行时容器，php init、php yii migrate 这类命令仍需在 CMD/PowerShell 中执行，且工作目录必须是项目根目录（不是 web 子目录）。

先 cd 到 C:\phpEnv\www\myapp，再运行 php init → 选 1（Production）→ 输入 y 确认
再运行 php yii migrate，注意此时 YII_ENV 必须生效，否则迁移会读错配置文件；可在命令前显式指定：set YII_ENV=prod && php yii migrate
如果提示 Class 'yii\db\Connection' not found，说明 vendor/autoload.php 没加载成功，回溯检查 index.php 中的 require 路径是否写错