FastAdmin在phpEnv中无法访问public目录，需将站点根目录手动设为public文件夹，否则导致404、open_basedir错误或后台空白；同时须开启伪静态、启用必要PHP扩展、配置runtime写权限及cdnurl。
phpEnv 启动后 FastAdmin 无法访问 public 目录
phpEnv 默认不自动指向 public 子目录，直接解压 FastAdmin 到站点根目录会导致 index.php 暴露在 Web 可访问路径下，存在安全风险，且路由会失效。
必须手动将站点「根目录」切换到 public 文件夹。操作路径：phpEnv → 网站 → 选中对应站点 → 「管理」→ 「修改」→ 将「根目录」改为项目路径下的 public（例如 D:\phpenv\www\fastadmin\public）。
常见错误现象：404 Not Found、Warning: require(): open_basedir restriction in effect、后台登录页空白。
- 切勿把整个 FastAdmin 包放在 phpEnv 的
www下就完事——那只是源码，不是可运行入口 - 如果改完仍 404，检查 phpEnv 是否启用了「伪静态」支持（新版 phpEnv 默认关闭），需手动开启或添加规则
- php 版本建议锁定为
7.4；8.0+ 在部分 FastAdmin 旧版中会出现ZipArchive类未定义或mbstring缺失报错
数据库配置写在哪？.env 还是 database.php
FastAdmin 优先读取 .env 文件，但 phpEnv 环境下常因权限或加载顺序问题导致 .env 未生效，此时实际走的是 application/database.php。
立即学习“PHP免费学习笔记（深入）”；
稳妥做法：两个地方都配，且保持一致。尤其注意字符集必须为 utf8mb4，否则中文菜单/日志入库乱码。
-
.env中写法：DB_TYPE=mysql、DB_HOST=127.0.0.1、DB_NAME=fastadmin、DB_USER=root、DB_PASS=（空密码也要显式写DB_PASS=） -
application/database.php中对应项不能留空字符串，例如'password' => Env::get('DB_PASS', '')，否则连接失败报Access denied for user 'root'@'localhost' - 若用 phpEnv 自带的 MySQL（非系统全局服务），端口可能不是
3306，请进 phpEnv → 数据库 → 查看「端口」并同步填入
安装页面卡在「正在检测环境」或跳转 /install.php 报 500
本质是 PHP 扩展缺失或 runtime 目录不可写。FastAdmin 安装器依赖 curl、openssl、pdo_mysql、mbstring、fileinfo，缺一不可。
phpEnv 的 PHP 配置文件（php.ini）默认注释掉了部分扩展，需手动取消注释：
- 搜索
;extension=php_curl.dll→ 改为extension=php_curl.dll - 同理启用
php_openssl.dll、php_mbstring.dll、php_fileinfo.dll - 确认
extension_dir指向正确（如ext文件夹在 php 安装路径下） -
runtime目录权限：右键runtime→ 属性 → 安全 → 给 Users 组「写入」权限（Windows 下常见坑）
安装成功但后台登录后白屏或 JS 报错
大概率是静态资源路径没走通，尤其是 cdnurl 配置为空 + 伪静态未生效，导致 /assets/ 下的 JS/CSS 被 Nginx/Apache 拦截为 404。
phpEnv 内置 Apache，其默认不支持 .htaccess 重写，必须手动配置 httpd-vhosts.conf 或启用 AllowOverride All。
- 打开 phpEnv → Apache → 配置 → 编辑
httpd-vhosts.conf，找到对应虚拟主机段，在<Directory>块内加入：AllowOverride All - 检查
application/config.php中'cdnurl' => ''是否为空；若为空，FastAdmin 会尝试用相对路径加载资源，但在子目录部署时容易出错，建议设为完整域名（如'cdnurl' => 'http://your-site.com'） - 浏览器按 F12 查 Network 面板，过滤
js或css，看是否有 404 请求——有则说明路径或重写规则没生效
runtime 权限、以及 Apache 对 .htaccess 的实际支持程度——这三个点不逐个验证，光看界面提示容易误判。 
