从零基础到落地，ThinkPHP（TP）全栈实战教程

在PHP Web后端开发领域，ThinkPHP（以下简称TP）是国内开发者耳熟能详的开源PHP框架之一，作为一款国产轻量级高效开发框架，ThinkPHP凭借简洁优雅的语法规范、详尽完善的中文官方文档，以及开箱即用的快速开发特性，成为中小企业后台管理系统、电商平台、个人博客等项目的首选开发框架之一，对于刚接触PHP后端开发的零基础开发者而言，掌握TP框架不仅能快速上手企业级Web开发流程，还能建立起完整的后端开发思维逻辑，本教程将从最基础的环境搭建开始,一步步带领你从TP入门小白成长为能够独立完成实战项目的资深开发者。

前期准备与项目初始化

开发环境搭建

TP6作为目前国内PHP开发中使用率最高的稳定主流版本，官方要求PHP版本不低于7.4，且推荐使用7.4~8.2之间的稳定版本以获得最佳兼容性，同时需要搭配MySQL5.7+版本的数据库，以及Apache/Nginx其中一款Web服务器，对于零基础开发者来说，借助可视化运维面板可以大幅降低环境搭建的门槛,省去手动编译配置的繁琐步骤：

• Windows环境：推荐优先使用XAMPP或WAMP Server，二者均为一键集成PHP、MySQL、Apache的绿色/安装包工具，下载官方安装包后按照向导指引完成安装即可快速搭建基础环境；如果需要更便捷的站点、数据库可视化管理功能，也可以选择宝塔Windows面板，支持一键创建站点、配置域名、管理数据库等进阶操作。
• Linux环境：推荐使用LNMP一键安装包或宝塔Linux面板，仅需几分钟即可完成完整的Web环境搭建，无需手动配置编译参数、环境变量等复杂内容,新手也能轻松上手。
• 环境验证：安装完成后，若使用集成面板需先创建站点并指定网站根目录为环境对应的Web目录，随后在浏览器访问http://localhost或绑定的站点域名，如果能正常看到PHPinfo信息页面，说明Web环境配置成功，如果出现403权限错误,可检查站点目录的读写权限是否配置正确。

TP6框架安装

TP6提供两种主流安装方式，新手可以先选择手动压缩包安装快速熟悉开发流程,熟练后再使用Composer进行规范化的依赖管理：

• 手动压缩包安装：访问ThinkPHP官方中文网站的下载页面，下载最新稳定版的TP6完整版压缩包，解压后将所有文件复制到Web服务器的站点根目录下即可完成安装，注意需确保站点目录拥有正确的读写权限,避免后续开发中出现文件无法写入的问题。
• Composer安装（官方推荐）：Composer是PHP生态中主流的依赖包管理工具，也是ThinkPHP官方推荐的安装方式，能够自动管理框架依赖并快速更新版本，由于国内网络环境限制，建议先配置国内Composer镜像源以加速安装：在命令行执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可切换至阿里云官方镜像。 具体安装步骤如下：
  1. 访问Composer中文官网下载对应系统的安装包，完成安装后打开命令行工具，输入composer -v，若能输出Composer的版本信息,则说明安装成功。
  2. 进入想要创建项目的目录，执行composer create-project topthink/think tp6，等待命令执行完成后，会在当前目录生成名为tp6的TP6标准项目文件夹。

项目启动与基础配置

进入项目目录执行cd tp6，TP6内置了轻量的内置Web开发服务器，无需额外配置Nginx/Apache即可快速启动本地调试环境：

1. 在命令行执行php think run即可启动开发服务器，默认监听http://127.0.0.1:8000，在浏览器访问该地址，若能看到ThinkPHP的官方欢迎页面,则说明项目初始化成功。
2. 若默认端口8000被其他程序占用，可以通过php think run -p 8001命令自定义修改监听端口。
3. 接下来需要完成基础的数据库连接配置：打开项目根目录下的.env文件（若不存在可复制同目录下的.example.env并重命名为.env），找到数据库相关配置项并修改为你本地的数据库信息：

   # 数据库类型
   DB_TYPE=mysql
   # 数据库服务地址
   DB_HOST=127.0.0.1
   # 数据库端口，默认3306
   DB_PORT=3306
   # 你本地创建的数据库名称
   DB_NAME=your_database_name
   # 数据库登录用户名，默认root
   DB_USER=root
   # 数据库登录密码，根据你的实际配置修改
   DB_PASSWD=your_password
   # 数据库编码，推荐使用utf8mb4支持完整emoji表情
   DB_CHARSET=utf8mb4

   修改完成后保存文件即可完成数据库连接配置,后续即可基于该配置进行数据库相关的开发工作。

新手小贴士：如果是Linux环境下使用宝塔面板，需要将站点目录的所有者修改为www用户，避免出现文件读写权限报错,可以通过宝塔面板的文件管理器快速配置权限。