FastAdmin 在 phpEnv 中需将 Web 根目录设为 public/ 并启用 mod_rewrite，否则因入口路径错误、伪静态失效导致 404 或路由异常；还需开启 mysqli/pdo_mysql 扩展、DB_HOST 改用 127.0.0.1、配置 date.timezone。
phpEnv 本身不是 FastAdmin 的官方支持环境，它只是一个 Windows 下的 PHP 集成套件（类似 phpStudy），不自带 ThinkPHP 运行时优化或 FastAdmin 专用配置。直接把 FastAdmin 放进去跑，大概率会遇到 404、路由失效、静态资源 403、数据库连不上等问题——根本原因在于 phpEnv 默认用的是 Apache + htdocs 根目录，而 FastAdmin 必须以 public/ 为 Web 入口目录，且需要 URL 重写支持。
为什么直接放 phpEnv 里打不开 /admin 页面？
FastAdmin 基于 ThinkPHP 5.1，所有请求必须经由 public/index.php 统一入口。但 phpEnv 默认把整个项目根目录当 Web 根，导致：
-
/admin被 Apache 当作子目录直接找文件，跳过路由分发 → 404 -
public/下的.htaccess文件未生效（Apache 未开启mod_rewrite或AllowOverride All）→ 伪静态失效 - 静态资源（JS/CSS）路径错乱，因为
__ROOT__变量依赖正确的入口位置 → 控制台报 404
怎么让 FastAdmin 在 phpEnv 中真正跑起来？
核心动作只有两个：改 Web 根目录 + 开启重写。操作路径（以 phpEnv v2.0+ 为例）：
- 打开 phpEnv 主界面 → 点击「网站」→ 「添加网站」
- 「网站根目录」选到你的 FastAdmin 项目里的
public/子目录（不是项目根目录！） - 「网站端口」建议用非 80 端口（如 8080），避免和系统其他服务冲突
- 点击「配置 Apache」→ 找到对应虚拟主机配置段，在
<directory></directory>内确保有：AllowOverride All<br>Require all granted
- 确认 Apache 的
mod_rewrite已启用（phpEnv 界面「模块管理」里勾选） - 重启 Apache
此时访问 http://localhost:8080 就该看到 FastAdmin 安装向导了。
立即学习“PHP免费学习笔记（深入）”；
安装后进后台白屏或提示“Database connection failed”？
这是 phpEnv 默认没开 MySQL 扩展或数据库服务没启动。检查三处：
- phpEnv 主界面 → 「服务」→ 确保 MySQL 和 Apache 都是「运行中」状态
- 「PHP 设置」→ 「扩展」→ 勾选
php_mysqli.dll和php_pdo_mysql.dll（缺一不可） -
.env文件里DB_HOST不要写localhost，改用127.0.0.1（Windows 下 localhost 有时走命名管道，失败率高）
如果仍连不上，手动在 phpEnv 自带的 phpMyAdmin（通常是 http://localhost:8080/phpmyadmin）里建库并导入 public/install.sql，再跑迁移：php think migrate:run（在项目根目录下执行，不是 public/）
伪静态规则没生效？别硬套 .htaccess
phpEnv 的 Apache 版本较老（常为 2.4.x），默认不读取 .htaccess，必须把重写规则写进虚拟主机配置里：
<IfModule mod_rewrite.c><br> Options +FollowSymlinks -Multiviews<br> RewriteEngine On<br> RewriteCond %{REQUEST_FILENAME} !-d<br> RewriteCond %{REQUEST_FILENAME} !-f<br> RewriteRule ^(.*)$ index.php/$1?%{QUERY_STRING} [L]<br></IfModule>这段要放在 <directory></directory> 段内，而不是靠 .htaccess 自动加载。否则所有带参数的 URL（比如 /admin/index/index?ref=addtabs）都会 404。
最易被忽略的一点：phpEnv 没有自动设置 date.timezone，PHP 报错里一堆时区警告，不影响功能但干扰调试 —— 记得在「PHP 设置」→ 「php.ini」里补上 date.timezone = "Asia/Shanghai"。
