phpEnv安装Yii2框架及配置伪静态 phpEnv部署Yii2步骤-php教程-PHP中文网

yii2在phpenv中伪静态失效主因是根目录未设为web子目录、allowoverride未启用及urlmanager配置不匹配；须将网站目录指向web、开启allowoverride all、配置enableprettyurl并确保.htaccess生效。

phpenv安装yii2框架及配置伪静态 phpenv部署yii2步骤

phpEnv 下部署 Yii2 最容易卡在根目录设错和伪静态规则不生效上，直接后果是 500 错误或 index.php 被当普通文件下载。关键不是“能不能装”，而是 Web 服务器是否只暴露 web/ 目录、urlManager 配置是否与服务器重写能力匹配。

phpEnv 中站点根目录必须指向 web 子目录

phpEnv 默认新建站点时，根目录会设为项目根路径（如 D:\phpenv\www\myapp），但 Yii2 的敏感配置（config/、runtime/、vendor/）都在其上层。一旦被 Web 服务器直接访问，轻则报错，重则泄露数据库配置。

打开 phpEnv 控制面板 → 「网站管理」→ 编辑你的站点 → 将「网站目录」改为 D:\phpenv\www\myapp\web（不是项目根目录）
确认 web/index.php 文件存在且权限可读；若用高级版，需分别为 frontend/web 和 backend/web 建两个独立站点
检查 phpEnv 使用的 Apache 版本：2.4+ 才支持 Require all granted，旧版要用 Order allow,deny + Allow from all
Windows 下注意 php.ini 是否加载正确：运行 php --ini 看 CLI 加载路径，再查 Apache 模块里实际用的是哪份（常位于 phpenv\apache\conf\extra\php.ini）

Apache 伪静态（.htaccess）必须放在 web 目录且启用 AllowOverride

phpEnv 内置 Apache，默认关闭 .htaccess 解析。即使你写了规则，没开 AllowOverride All 就等于白写，enablePrettyUrl 会静默失效，URL 里始终带 index.php。

btpanel phpsite 宝塔面板PHP网站

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

下载

在项目 web/ 目录下新建文件，命名为 .htaccess（注意开头有个点，Windows 资源管理器可能不显示，可用记事本另存为选择“所有文件”类型）
内容严格按以下写（别加空行、别漏空格）：

Options +FollowSymLinks
IndexIgnore */*
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php

编辑 phpEnv 对应站点的 Apache 配置文件（通常在 phpenv\apache\conf\vhost\your-site.conf），找到 <directory></directory> 这一段，把它改成指向 web 目录，并确保包含：

<directory>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</directory>

重启 phpEnv 的 Apache 服务（不是仅刷新页面）

Yii2 的 urlManager 配置要和服务器能力对齐

enablePrettyUrl 开了但 URL 还带 index.php？大概率是上面两步没做对。另外，showScriptName 设为 false 后，如果重写失败，Yii2 会直接返回 404，而不是降级回带 index.php 的链接。

在 common/config/main.php（高级版）或 config/web.php（基础版）的 components 数组中添加：

'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
    'rules' => [
        '<controller:>/<id:>' => '<controller>/view',
        '<controller:>/<action:>' => '<controller>/<action>',
    ],
],</action></controller></action:></controller:></controller></id:></controller:>

不要盲目复制网上带 <module:></module:> 的规则——基础版没 module 层，会导致路由 404
高级版前后端要分开配：frontend/config/main.php 和 backend/config/main.php 各自加一份 urlManager，且 baseUrl 不同（前端通常为 /，后台建议设为 /admin 避免冲突）
验证是否生效：访问 http://localhost/site/about，能正常显示即 OK；若 404，先看 Apache 错误日志里有没有 Invalid command 'RewriteEngine'（说明 mod_rewrite 没启用）

常见 500 错误的定位顺序

phpEnv 下 Yii2 报 500，90% 和路径、权限、扩展缺失有关，而不是代码逻辑问题。别急着改 PHP 代码，先看日志。

第一步：打开 phpEnv 的 Apache 错误日志（路径一般为 phpenv\apache\logs\error.log），搜 PHP Fatal error 或 require(): Failed opening required
第二步：如果看到类似 Failed opening required '/D:/phpenv/www/myapp/requirements.php'，说明入口文件加载路径错了——根目录没设到 web/，导致 index.php 从错误位置加载了相对路径
第三步：检查 PHP 扩展是否启用：在浏览器访问 http://localhost/phpinfo.php（phpEnv 自带），确认 pdo_mysql、mbstring、openssl、json 全部为 enabled
第四步：Windows 下特别注意：phpEnv 的 Apache 和 CLI 可能用不同 php.ini，php -m 显示有 pdo_mysql，不代表 Apache 模块也加载了，得在 phpinfo() 页面里核对

伪静态不是“开了就完事”，它依赖 Web 服务器配置、框架配置、文件位置三者咬合。少一个齿轮，整个链路就卡死。最常被跳过的其实是 AllowOverride All 和 .htaccess 文件名是否真正生效——很多人以为建了文件就行，其实 Windows 下它极容易变成 .htaccess.txt。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！