phpEnv配置Yii2框架站点 phpEnv高级版与基础版目录配置教程-php教程-PHP中文网

yii2在phpenv中配置成功的关键是：站点根目录必须设为web子目录，确保index.php能加载vendor/autoload.php，且runtime和assets目录可写；advanced版需分设前后台两个独立站点；关闭伪静态更稳定；注意open_basedir限制和权限问题。

phpenv配置yii2框架站点 phpenv高级版与基础版目录配置教程

phpEnv 配置 Yii2 时，核心问题不是“能不能跑”，而是「web 目录是否被正确暴露、index.php 是否能加载 vendor/autoload.php、以及 runtime 和 assets 是否可写」——这三个点卡住，90% 的白屏或 500 错误就来了。

phpEnv 中 Yii2 Basic 版本的根目录必须指向 `web/` 子目录

Basic 模板结构里，index.php 只在 web/ 下；若把 phpEnv 站点根目录设成项目根（比如 /path/to/basic），访问时会报：require(): Failed opening required '/path/to/basic/vendor/autoload.php' ——因为 index.php 用的是相对路径 ../vendor/autoload.php，但当前工作目录是站点根，不是 web/。

实操建议：

PHP

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

下载

在 phpEnv「站点管理」中，「网站根目录」填完整路径，例如 /D:/phpEnv/www/basic/web（Windows）或 /Users/xxx/www/basic/web（macOS）
确认该路径下真实存在 index.php 和 assets/ 目录
别指望 phpEnv 自动识别 Yii2 结构——它不读 composer.json，也不解析框架约定

phpEnv 高级版（Advanced）必须分前台/后台两个独立站点

Advanced 模板有 frontend/web 和 backend/web 两套入口，它们共享 common/ 但 session、cookie path、URL 路由完全隔离。phpEnv 不支持单站点多入口路由映射，硬塞进一个根目录会导致 backend 资源 404 或登录态丢失。

实操建议：

新建两个站点：一个根目录为 /path/to/advanced/frontend/web，绑定域名如 front.test
另一个根目录为 /path/to/advanced/backend/web，绑定域名如 admin.test
两个站点 PHP 版本保持一致（推荐 7.4+），且都开启 openssl、mbstring、pdo_mysql
修改 backend/web/index.php 中的 $appConfig 路径，确保指向 ../../environments/dev/backend/web.php（开发环境）或 ../../environments/prod/backend/web.php（生产）

phpEnv 下 Yii2 伪静态失效？直接关掉「重写支持」更稳

phpEnv 内置的 Apache 模块默认不启用 mod_rewrite，即使你手动改了 .htaccess，也大概率被忽略；而它的 Nginx 模式又不开放配置文件编辑权限。强行配 rewrite 规则反而容易触发 ERR_TOO_MANY_REDIRECTS 或 404。

实操建议：

放弃美化 URL，先让功能跑通：在 config/web.php 中设 'enablePrettyUrl' => false，保留 index.php?r=site/login 这种形式
若坚持要隐藏 index.php，唯一可靠方式是改用系统级 Web 服务器（如宝塔、XAMPP），phpEnv 不适合生产级 URL 重写场景
检查 urlManager 配置里 'showScriptName' => false 是否生效——这仅在重写启用时起作用，否则无效

`runtime` 和 `assets` 权限在 phpEnv 里经常被重置

phpEnv 启动/重启服务时，有时会递归 chown 整个站点目录到内置用户（如 apache 或 www-data），导致原本属主是当前用户的 runtime/ 目录不可写，日志写不进、缓存生成失败，表现就是空白页且无错误提示。

实操建议：

启动 phpEnv 前，在终端进到项目目录，手动执行：chmod -R 755 runtime assets（Windows 下用 phpEnv 自带终端，右键「以管理员身份运行」再 chmod）
如果用了 Git 克隆项目，注意 runtime/ 默认被 .gitignore 排除，首次运行 php init 才生成；没 init 就配站点，必然报错
Windows 用户特别留意：phpEnv 的 Apache 服务常以 SYSTEM 身份运行，它对 NTFS 权限敏感，建议把整个项目放非系统盘（如 D:\），避免 UAC 干预

最易被忽略的一点：phpEnv 的「PHP 设置」里默认开了 open_basedir，值通常是 /D:/phpEnv/www/:/tmp/:/proc/。如果你的项目在 D:/myproject/，就必须手动把 open_basedir 改成 /D:/myproject/:/tmp/:/proc/，否则连 vendor/autoload.php 都 require 不进来——这个限制比 nginx 的 root 配置更隐蔽，也更致命。