最稳方式是用Composer安装：执行composer create-project topthink/think tp5 dev-master --prefer-dist，确保PHP≥5.4、Composer≥2.0，并配置阿里云镜像；public必须设为Web根目录，runtime需可写，数据库配置以app/database.php为准。
直接用 Composer 安装最稳，别下 ZIP 包
ZIP 包解压后常缺 vendor 目录或权限混乱，尤其 Windows 下容易报 Class 'think\App' not found。Composer 安装能自动拉取所有依赖、生成自动加载文件、校验版本兼容性。
执行前确认：php -v 输出 ≥ 5.4（推荐 7.2+），composer --version ≥ 2.0；国内用户务必先切镜像：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/- 进 WEB 根目录（如
E:\phpStudy\WWW），运行：composer create-project topthink/think tp5 dev-master --prefer-dist - 注意：不是
topthink/think=5.0.*，那个已过时；dev-master对应当前 TP5 最终稳定分支（截至 2026 年 5 月）
public 目录必须是 Web 根目录，否则 404 或路径错误
ThinkPHP5 强制分离入口和静态资源，public 是唯一可被外部访问的目录。若把整个 tp5 文件夹放 Apache 的 htdocs 下，直接访问 http://localhost/tp5/ 会报错或跳转失败。
正确做法分两类：
立即学习“PHP免费学习笔记（深入）”；
- 本地开发用内置服务器：
cd tp5 && php -S 0.0.0.0:8000 public/router.php（注意参数是public/router.php，不是index.php） - 生产/集成环境（如 phpStudy）：在虚拟主机配置中，
DocumentRoot必须指向tp5/public，不是tp5；同时确保AllowOverride All已启用，否则路由重写失效
数据库配置写在 app/database.php，不是根目录的 database.php
TP5 的配置体系是「应用级覆盖」，根目录下的 database.php 是框架默认模板，实际生效的是 app/database.php。新手常改错位置，导致连库始终用默认 root@localhost 报错。
编辑 app/database.php 时注意三点：
-
'hostname'建议写127.0.0.1而非localhost（避免 MySQL socket 连接干扰） -
'database'名必须已存在，TP5 不自动建库；导入 SQL 前先用 phpMyAdmin 创建空库 - 密码含特殊字符（如
@、/）要 URL 编码，例如pass@123→pass%40123
runtime 目录必须可写，否则白屏无报错
TP5 默认把缓存、日志、模板编译结果全写进 runtime，该目录权限不足时，页面直接空白，且 PHP 错误日志里可能只有一行 failed to open stream: Permission denied，极难定位。
Windows 下常见坑：
- 用 phpStudy 时，
runtime所在盘符（如E:）被系统策略限制写入 - 解压 ZIP 包后，
runtime子目录继承了压缩包只读属性 - 解决方法：右键
runtime→ 属性 → 取消「只读」，再进命令行执行：attrib -r runtime /s /d
Linux/macOS 下则需：chmod -R 755 runtime，不要用 777——TP5 的日志写入机制对组写权限敏感，777 反而触发安全拦截。
