本文中提到的TP,特指国内PHP开发领域极具影响力的主流后端框架ThinkPHP(以下简称TP),截至目前,ThinkPHP的最新稳定版本为8.0,这款遵循Apache2.0开源协议的轻量高效快速开发框架,凭借简洁优雅的语法规范、覆盖全场景的功能组件以及成熟完善的社区生态,稳居国内PHP开发者最常用的后端框架前列,不管你是刚接触编程的零基础新手,还是需要快速落地企业级应用的资深后端开发者,这套从环境搭建到项目上线的完整入门教程,都能帮你快速吃透TP框架的核心开发技能。
环境准备与TP框架安装
ThinkPHP框架的正常运行,离不开PHP运行环境、Web服务器以及数据库三大核心组件,对于编程新手来说,手动配置环境很容易遇到版本不兼容、服务启动失败等问题,因此我们推荐使用集成开发环境快速搭建本地开发环境,大幅降低入门门槛。
开发环境搭建
Windows用户
可以选择XAMPP、WAMP等一站式集成包,一键预装Apache/Nginx、PHP、MySQL三大核心组件,无需手动逐个配置,Windows 11用户还可以通过WSL2搭建Linux开发环境,兼顾Windows的易用性和Linux的开发效率。
实操小贴士:下载时请务必选择搭载PHP8.0及以上版本的集成包,匹配TP8的版本要求,下载对应安装包后直接运行,按照安装向导完成配置即可,安装完成后启动Apache和MySQL服务,在浏览器输入
http://localhost即可验证环境是否正常:如果看到XAMPP/WAMP的官方欢迎页面,说明环境搭建成功,如果遇到80端口被占用的情况,可以修改Apache的监听端口为8080,后续访问时输入http://localhost:8080即可。
Linux/Mac用户
推荐两种快捷搭建方式:
- 手动搭建LNMP/LAMP环境:Linux用户可以通过包管理器快速安装,比如Ubuntu系统执行
sudo apt install apache2 mysql-server php8.0 php8.0-mysql php8.0-curl php8.0-xml即可一键安装所需组件;Mac用户可以通过Homebrew执行brew install php@8.0 mysql nginx完成安装。 - Docker容器部署:对于熟悉容器技术的用户,可以直接使用官方的LNMP开发镜像,或者拉取预装TP开发环境的镜像快速启动容器,无需手动配置环境变量。
通用要求:无论选择哪种方式,都需要确保PHP版本≥8.0(TP8官方推荐版本)、MySQL版本≥5.6,同时在php.ini配置文件中开启
extension=pdo_mysql和extension=curl等常用PHP扩展,避免后续开发中出现依赖报错。
TP8框架的下载与安装
完成基础环境搭建后,我们就可以开始安装ThinkPHP 8.0框架了,官方推荐使用Composer进行框架安装,这也是目前最通用、最便捷的项目初始化方式,能够自动管理框架依赖的各类扩展包。
第一步:安装并配置Composer
首先需要在本地安装Composer工具:
- 前往Composer官方网站https://getcomposer.org/ 下载对应系统的安装包,运行安装向导即可完成安装。
- 国内用户由于网络限制,建议提前配置Packagist国内镜像以加速依赖下载:打开终端执行以下命令即可切换为阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 安装完成后,在终端输入
composer -V,如果能看到Composer的版本信息,说明安装配置成功。
新手备用方案:如果暂时不熟悉Composer,也可以直接前往ThinkPHP官方网站https://www.thinkphp.cn/ 下载最新的稳定版压缩包,解压到本地网站根目录(比如XAMPP的
htdocs文件夹下)即可直接使用。
第二步:创建TP8项目
通过Composer创建TP8项目的操作非常简单:
- 打开终端,进入本地网站根目录(比如Mac用户执行
cd /Applications/XAMPP/htdocs,Windows用户执行cd D:\xampp\htdocs)。 - 执行以下命令创建名为
tp8-demo的TP8项目:composer create-project topthink/think tp8-demo
- 等待依赖安装完成后,进入项目目录并启动TP内置的开发服务器:
cd tp8-demo php think run
- 在浏览器输入
http://localhost:8000,如果看到ThinkPHP的官方欢迎页面,说明TP8框架安装成功。
