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

作者：袖梨 2026-07-21

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 文件：