phpEnv运行ThinkPHP6环境要求及配置详解-php教程-PHP中文网

根本原因是web服务器未指向tp6的public/目录，而应将站点根目录设为项目/public路径；同时需确保.env在根目录且有读权限、runtime/可写、数据库配置正确及composer指定^6.1版本。

phpenv运行thinkphp6环境要求及配置详解

根本原因是 Web 服务器没指向 public/ 目录，而是直接映射到了项目根目录（含 think 文件的那层）。TP6 强制入口统一收口到 public/index.php，所有静态资源、路由解析、__ROOT__ 路径都依赖这个结构。

在 phpEnv 中配置站点时，必须手动把「站点根目录」设为 tp-demo/public（或你项目的 xxx/public），不是 tp-demo。这点被跳过就会全程 404 —— 连首页都打不开，更别说路由和 CSS 加载。

Apache 用户：确认虚拟主机的 DocumentRoot 指向的是 public/，且 .htaccess 生效（phpEnv 默认已配好 AllowOverride All）
Nginx 用户：在 phpEnv 的「网站 → 配置 → URL重写」里选中 thinkphp 规则；同时检查 root 行是否明确写成 root /path/to/tp-demo/public;
Windows 下用 hosts 绑定本地域名（如 www.tp6.test）后，浏览器输域名打不开？先 ping 一下确认解析正常，再查 phpEnv 是否已启动对应站点服务

官方早已不再将 topthink/think 的 latest 标签指向 TP6，当前稳定版是 ^6.1。不显式指定版本，Composer 默认会尝试拉取最新分支（比如 dev-main，即 TP8 开发版），而它和 TP6 完全不兼容。

正确命令只有一条：

composer create-project "topthink/think:^6.1" tp6-demo

注意引号不能省——Windows CMD 和某些 Shell 对 ^ 符号敏感，不加引号会被提前解析掉。

如果已误装了非 TP6 版本，别改 composer.json 后 update：TP8 的目录结构、命名空间、核心类名全变了，硬升/硬降大概率报 Class not found
执行前确认 Composer 已全局可用：composer -v 能输出版本（建议 ≥2.2）；若提示“不是内部命令”，说明 phpEnv 的 Composer 没加入系统 PATH，需手动到 phpEnv 安装目录下的 tools/composer 里运行
国内用户务必提前换源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer，否则超时失败极常见

TP6 的环境变量只在应用初始化早期加载一次，且严格依赖文件位置和权限。写错地方、权限不对、或没重启进程，都会导致 .env 形同虚设。

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

下载

必须满足这三点：

.env 文件得放在项目**根目录**（和 think、composer.json 同级），不是 app/ 下，也不是 public/ 下
Linux/macOS 下运行 ls -l .env，确保当前 Web 服务用户（如 www-data 或 _www）有读权限；Windows 一般无此问题，但要确认文件没被记事本另存为 UTF-8 with BOM（会导致解析失败）
改完 .env 后，必须重启服务：Apache/Nginx 要 reload，用 php think run 的得 Ctrl+C 再重跑，内置服务器 php -S 也得停掉重起

快速验证是否生效：在 app/common.php 顶部加一行 var_dump($_ENV['APP_DEBUG'] ?? 'not loaded');，刷新页面看输出。输出 bool(true) 才算真正加载成功。

TP6 的 runtime/ 是运行时日志、缓存、模板编译的落盘目录，默认在项目根目录下。Web 服务用户没写入权限，就卡在「无法创建目录」或「Permission denied」。

phpEnv 默认用 Windows 服务方式运行 Apache/Nginx，实际是以 SYSTEM 或 LocalService 身份启动，对用户目录（如 C:\Users\XXX\）下的项目路径常无写权限。

最稳妥做法：把项目建在 phpEnv 自带的网站目录里（如 D:\phpEnv\www\tp6-demo），该路径默认可写
若坚持放其他盘符或自定义路径，右键项目根目录 → 属性 → 安全 → 编辑 → 添加 IIS_IUSRS（IIS）或 Users（Apache）组，并勾选「完全控制」
数据库配置优先填在 .env 里（DATABASE.HOSTNAME=127.0.0.1 等），比改 config/database.php 更灵活；但注意 .env 里的 DATABASE.TYPE 必须小写（mysql、pgsql），大写会静默失败
连接 HGDB（瀚高数据库）？确认 phpEnv 的 PHP 已开启 pdo_pgsql 和 pgsql 扩展：打开 php.ini（路径见 phpEnv 设置页），去掉这两行前面的分号 ;，然后重启 phpEnv 服务