ThinkPHP快速部署教程 一站式安装配置指南

ThinkPHP快速部署关键在于四点对齐：PHP 8.0+版本及pdo_mysql等扩展、用composer create-project初始化项目、Web服务器根目录必须指向public、正确配置.env文件并清理runtime缓存。

ThinkPHP快速部署的关键不在“装得多快”，而在于“每一步都踩准位置”。很多人卡在白屏、404或500错误上，其实不是框架难，是几个核心环节没对齐：PHP版本、项目初始化方式、Web服务器根目录、以及配置加载顺序。只要这四点理清楚，从零到可访问页面，10分钟内能完成。

确认PHP版本与必要扩展

ThinkPHP 8.x 必须运行在 PHP 8.0 或更高版本（推荐 8.1/8.2）。执行 php -v 查看当前版本；若不满足，需单独安装——Windows 用户直接下载 php.net 的线程安全版，Mac 用户用 brew install [email protected]，Ubuntu 用户则添加 ondrej/php 源后安装 php8.1。安装后还需启用以下扩展：pdo_mysql、mbstring、openssl、curl、fileinfo。宝塔面板可在 PHP 设置 → 安装扩展中一键勾选；命令行环境可通过 php --ini 找到配置文件，取消对应扩展的注释并重启服务。

用 create-project 初始化项目（不是 require）

这是最容易出错的一步。ThinkPHP 是完整项目结构，不能靠 composer require topthink/think 往已有项目里硬塞。正确做法是在空目录下执行：

• composer create-project topthink/think tp8（创建名为 tp8 的项目）
• 如需指定小版本，加 @8.0.10 后缀
• 执行后会自动生成 public/、app/、config/、runtime/ 等标准目录，且包含可执行的 think 脚本

完成后进入项目目录，php think run 可立即启动内置服务器（默认 http://127.0.0.1:8000），验证是否成功。

立即学习“PHP免费学习笔记（深入）”；

Web服务器必须指向 public 目录

这是线上部署最常被忽略的致命点。ThinkPHP 的入口统一在 public/index.php，而 .env、config/、app/ 等敏感目录绝不能被 Web 直接访问。因此：

• Apache：确保站点 DocumentRoot 指向 /path/to/tp8/public，而非项目根目录
• Nginx（含宝塔）：在网站设置 → 网站目录中，将“运行目录”改为 /public
• 宝塔还必须同步开启伪静态，并填入规则：
  location / { try_files $uri $uri/ /index.php?$query_string; }

配置优先级与缓存清理

ThinkPHP 默认读取根目录下的 .env 文件，它会覆盖 config/database.php 等 PHP 配置。常见问题包括：

• 修改了 .env 却没生效？先确认该文件未被注释（如 # APP_DEBUG=true 要删掉 #）
• 数据库连不上？写法是 DB_HOST=127.0.0.1，不是 database.host
• 改完配置仍报错？清空 runtime/cache/ 目录，否则旧缓存会干扰新设置
• 命令行工具失效？检查 php think 是否在项目根目录执行，并确认 CLI 使用的 PHP 版本与 Web 一致（which php 和 php -v）