ThinkPHP搭建本地环境怎么操作 一文教你如何完成部署

ThinkPHP本地环境搭建核心在于项目结构、PHP版本、Web服务器指向public目录和.env加载时机四环节严丝合缝：必须用composer create-project初始化完整项目，PHP≥7.2.5且CLI与Web端版本一致，Web服务器DocumentRoot或root必须指向public/，.env需取消APP_DEBUG=true注释并重启服务。

ThinkPHP本地环境搭建不是“装个软件点下一步”就能完事，核心在于项目结构、PHP版本、Web服务器指向和环境加载时机四个环节严丝合缝。漏掉任何一环，轻则白屏报错，重则配置被外部直接访问。

第一步：用 Composer 创建完整项目结构

别解压 ZIP，也别用 composer require —— 那只会拉取半截框架，缺入口文件、缺命令脚本、缺路由支持，必然报 Class 'thinkApp' not found 或 404。

• 确保已安装 Composer（运行 composer --version 验证）
• 在空目录下执行（TP6 推荐稳定版）：
  composer create-project "topthink/think:^6.1" myapp
• 完成后进入 myapp/ 目录，确认存在 think 文件、public/ 目录和根目录下的 .env

第二步：检查并统一 PHP 环境

TP6 要求 PHP ≥ 7.2.5，但强烈建议使用 PHP 8.0+；更要命的是，CLI 命令行用的 PHP 版本必须和 Web 服务器用的一致，否则 php think 正常，浏览器却报错。

• 终端执行：php -v 查 CLI 版本；访问 http://localhost/phpinfo.php 查 Web 版本
• Windows 用户常见陷阱：PATH 里有多个 PHP，CMD 默认调用旧版。用 where php 查路径，删掉冲突项
• 必须启用扩展：mbstring、openssl、pdo_mysql（或 pdo_sqlite），在 php.ini 中取消对应行前的分号

第三步：Web 服务器必须指向 public/ 目录

这是 ThinkPHP 单入口设计的硬性要求。映射到项目根目录 = 暴露 config/、app/、.env，且静态资源 404、路由全失效。

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

• Apache：修改虚拟主机配置，DocumentRoot 和 <Directory> 全部指向 /path/to/myapp/public，并设 AllowOverride All
• Nginx：root 指向 /path/to/myapp/public，且关键配置不能少：
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
• 开发偷懒法：直接在项目根目录运行：
  php -S localhost:8000 -t public/（注意 -t public/ 不可省）

第四步：激活调试 + 确认 .env 生效

.env 文件默认所有配置项都被注释，不手动开启就等于没配——你改了数据库密码，但框架根本读不到，只给你一个空白页或 500 错误。

• 打开根目录 .env，取消这行注释：
  APP_DEBUG=true
• 数据库配置写成扁平格式：
  

  DB_HOST=127.0.0.1<br>DB_NAME=mydb<br>DB_USER=root<br>DB_PWD=123456

• 改完必须重启服务：
  用 php think run 的要 Ctrl+C 再重跑；
  用 Apache/Nginx 的要重启服务；
  Linux/macOS 还要检查 .env 权限是否允许 Web 用户读取