TP框架安装全攻略，从零开始轻松搭建ThinkPHP环境

TP官方网站 2025年9月1日 08:03:46 TP下载中心 149

ThinkPHP（简称TP）作为国内最流行的PHP开发框架之一，以其简洁的语法、丰富的功能和良好的性能，深受广大PHP开发者的喜爱，无论是开发小型企业网站还是复杂的大型系统，ThinkPHP都能提供强有力的支持，对于初学者来说，如何正确安装和配置TP框架往往是第一步，本文将为您详细讲解两种主流的ThinkPHP安装方式,助您轻松踏上TP开发之旅。

安装前的准备工作

在开始安装TP之前,请确保您的计算机已经满足了以下基本运行环境要求：

Web服务器： Apache / Nginx / IIS (推荐使用Apache或Nginx)
PHP版本： ThinkPHP 6.0+ 需要 PHP 7.1.0 或更高版本，建议使用PHP 7.4或8.0，以获得更好的性能和安全性，您可以通过命令行输入 php -v 查看当前版本。
必要扩展： 确保PHP已开启或安装以下扩展：mbstring, json, openssl, pdo,这些是框架运行所依赖的核心扩展。
Composer： 这是现代PHP开发中不可或缺的依赖管理工具，ThinkPHP 6.0+ 主要使用Composer进行安装和管理，请前往 https://getcomposer.org/ 下载并安装。

两种主流的安装方式

使用Composer创建项目（官方推荐）

这是目前最简单、最标准的安装方式,Composer会自动处理框架的所有依赖关系。

打开命令行终端（Windows下为CMD或PowerShell，Linux/Mac为Terminal）。
切换目录到您打算创建项目的路径，cd /www/wwwroot。
执行创建命令：
```
composer create-project topthink/think tp-demo
```
这里的 tp-demo 是您的项目目录名称,可以自定义。
等待安装完成，Composer会自动从远程仓库下载ThinkPHP核心文件以及所有依赖包,这个过程耗时取决于您的网络速度。
启动内置服务器进行测试（可选），完成安装后,进入项目目录并启动PHP内置服务器：
```
cd tp-demo
php think run
```
之后在浏览器中访问 http://localhost:8000，如果看到ThinkPHP的欢迎页面，恭喜您！安装已经成功。

直接下载官方基础版（传统方式）

如果您不熟悉Composer，或者网络环境访问Composer较慢,也可以选择直接下载代码包。

访问ThinkPHP官方GitHub发布页面或官方网站（通常为 http://www.thinkphp.cn）找到最新稳定版的“完整版”或“基础版”下载链接。
将下载的ZIP压缩包解压到您的Web服务器根目录下（如Apache的 htdocs 目录），并重命名为您的项目名称，tp-app。
配置您的Web服务器，将网站根目录指向解压后的 public 文件夹，这是为了增强安全性，避免核心文件被直接访问。
- Apache：修改虚拟主机配置中的 DocumentRoot。
- Nginx：修改配置文件中 root 指向 path/to/tp-app/public。
在浏览器中访问您配置的域名或本地地址（如 http://localhost/tp-app/public）,看到欢迎页即表示成功。

注意： 此方式下载的版本可能不会包含所有扩展库，后续如需安装扩展,仍需使用Composer。

安装后的重要步骤

安装完成并看到欢迎页面只是第一步,接下来还需要进行一些配置以确保项目正常运行：

配置环境变量：复制项目根目录下的 .example.env 文件并重命名为 .env，这个文件用于配置数据库连接、应用调试模式等敏感信息,这是ThinkPHP多环境配置的核心。
调整目录权限：确保 runtime 目录（用于存放日志、缓存等）有可写权限,否则网站可能会报错。

配置数据库：编辑 .env 文件，修改您的数据库连接信息：

DATABASE_HOST=127.0.0.1
DATABASE_PORT=3306
DATABASE_DATABASE=test
DATABASE_USERNAME=root
DATABASE_PASSWORD=your_password

安装ThinkPHP框架是一个非常 straightforward（直接）的过程，对于新手和大多数开发者而言，强烈推荐使用Composer进行安装，因为它能高效地管理依赖，并与现代PHP开发流程保持同步，而直接下载的方式则更适合于快速体验或特殊网络环境，无论选择哪种方式，成功看到那经典的欢迎页面，都标志着您已经打开了ThinkPHP世界的大门，就让我们一起探索TP框架强大的MVC结构、数据库操作和路由功能吧！