ThinkPHP如何搭建开发框架 从安装到运行全过程

ThinkPHP搭建开发框架的核心是“环境准备→项目初始化→配置调整→启动验证”，必须通过Composer安装，TP6+强制要求该流程；需PHP≥7.1、启用关键扩展、配置镜像源，执行composer create-project创建项目，指向public目录，修改database.php和.env，运行php think run验证。

ThinkPHP 搭建开发框架的核心是“环境准备 → 项目初始化 → 配置调整 → 启动验证”，整个过程不依赖手动下载压缩包，而是以 Composer 为标准方式完成，尤其 TP6 及后续版本已强制要求此流程。

确保基础环境就绪

PHP 版本需 ≥7.1（推荐 8.0+），并启用 pdo_mysql、mbstring、openssl、json、xml 等扩展。用以下命令快速验证：

• php -v 查看 PHP 版本
• php -m | grep -E "pdo|mbstring|openssl" 检查关键扩展
• composer -v 确认 Composer 已安装；未安装请前往 composer.org 下载或执行一键脚本安装

若在国内，建议切换 Composer 镜像源提升速度：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer

创建 ThinkPHP 项目

在终端中执行命令，自动拉取最新稳定版（TP6 或 TP7）：

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

composer create-project topthink/think myapp

其中 myapp 是你的项目名，执行后会生成完整目录结构，包括 app（应用逻辑）、config（配置）、public（Web 入口）等核心目录。

注意：不要把 web 服务器根目录指向项目根目录，而必须指向 public 子目录 —— 这是安全前提，可防止配置文件、runtime 等敏感目录被直接访问。

配置数据库与基础参数

编辑 config/database.php，填入 MySQL 连接信息：

return [    'type'         => 'mysql',    'hostname'     => '127.0.0.1',    'database'     => 'myapp_db',    'username'     => 'root',    'password'     => '',    'hostport'     => '3306',];

如需开启调试模式（开发阶段必备），修改 .env 文件：

APP_DEBUG = trueLOG_LEVEL = 'debug'

该文件若不存在可手动创建于项目根目录，它会覆盖 config/app.php 中的对应设置。

启动服务并验证运行

进入项目目录，运行内置开发服务器：

cd myapp && php think run

默认监听 http://127.0.0.1:8000。浏览器打开该地址，看到 “Welcome to ThinkPHP” 页面即表示框架已正常运行。

如需自定义端口或绑定地址：

php think run -p 8080 -H 0.0.0.0

生产环境部署时，请改用 Nginx/Apache + PHP-FPM，并严格按官方推荐配置伪静态规则（如 Nginx 的 try_files 转发到 index.php）。