必须解压官方完整版压缩包并设public为文档根目录才能访问欢迎页;若404需检查是否漏掉/public/路径,错误指向整个项目文件夹会导致暴露敏感文件或报错。

ThinkPHP 文件本身不是需要“解压”的运行态文件,而是以压缩包形式分发的安装包。所谓“解压”,是指把官方下载的 .zip 或 .rar 安装包展开为可运行的目录结构——这一步必须做对,否则后续访问会 404、白屏或报错。
确认你拿到的是完整版压缩包
从 thinkphp.cn/down.html 下载的「ThinkPHP 完整版」是带 vendor、public、app 等标准目录的 ZIP 包(截至 2026 年 9 月最新稳定版为 6.1.x)。别误下「核心版」或「源码版」,它们不包含依赖和入口文件,无法直接运行。
解压到 Web 服务器根目录下,但不能直接用整个文件夹当网站根目录
将压缩包解压后,你会看到类似 thinkphp_6.1.0_full 的文件夹,里面含 public、app、runtime、vendor 等子目录:
- 把该文件夹整体复制进你的 Web 根目录(如 XAMPP 的 htdocs、phpStudy 的 WWW、Laragon 的 www)
- 重命名它为易记名称(比如 mytp),方便后续写路径
- 关键点:Web 服务器必须指向 public 目录,而不是 mytp 整个文件夹
解压后必须正确访问 public 入口
浏览器中输入的地址必须包含 /public/ 路径段:
- ✅ 正确:
http://localhost/mytp/public/—— 应显示「欢迎使用 ThinkPHP」 - ❌ 错误:
http://localhost/mytp/—— 会暴露 app/ 目录、报错或 403 - ❌ 错误:
http://localhost/mytp/public/index.php—— 多余加 index.php,可能触发重写异常
如果打开是 404,请回头检查是否漏掉了 /public/ 这一段;如果是空白页,先确认 public/index.php 首行是否为 define('APP_PATH', __DIR__ . '/../app/');。
特殊情况:虚拟主机或不能改根目录时怎么“解压”
有些共享主机只允许把文件传到 wwwroot,不支持设置 public 为根目录。这时不能靠“解压完就跑”,得手动调整:
- 把 public 目录下的所有文件(index.php、.htaccess 等)剪切出来,放到网站根目录(wwwroot)
- 把原项目根目录(app、config、runtime、vendor 等)整体上传到 wwwroot 的某个子目录(如 /thinkphp_app/)
- 修改根目录下的 index.php,把
__DIR__ . '/../app/'改成__DIR__ . '/thinkphp_app/app/' - 确保 .htaccess 或伪静态规则仍生效,否则路由会失效
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











