thinkphp开发环境搭建核心是装对php、用对composer、项目放对位置;需确认php≥8.0并启用mbstring等扩展,配置composer国内源,新建纯英文路径执行composer create-project topthink/think .并php think run启动。

ThinkPHP开发环境搭建,核心就三件事:装对PHP、用对Composer、项目放对位置。只要这三点没出错,5分钟内就能看到欢迎页。
确认PHP版本和必需扩展
ThinkPHP 8.0要求PHP ≥ 8.0,6.x推荐PHP 7.4或8.2+。打开命令行执行:
- php -v —— 看版本号,低于8.0必须升级
- php -m | findstr "mbstring openssl pdo_mysql fileinfo"(Windows)或 php -m | grep -E "mbstring|openssl|pdo_mysql|fileinfo"(Linux/macOS)—— 检查关键扩展是否启用
若缺失,编辑php.ini,取消对应extension前的分号;改完重启终端再验证。
安装并配置Composer
Composer是安装ThinkPHP的唯一标准方式。官网下载安装器后,在命令行运行:
- composer --version —— 确认安装成功
- composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ —— 切换国内源,避免卡在下载环节
如果提示“找不到指定模块”,大概率缺VC++运行库(Windows)或libzip(Linux),按系统补全即可。
创建项目并启动服务
新建一个纯英文、无空格、无中文的文件夹(如D:\tp8),进入后执行:
- composer create-project topthink/think . —— 注意末尾的英文句点,表示当前目录
- php think run —— 启动内置服务器(默认http://127.0.0.1:8000)
浏览器打开地址,出现ThinkPHP欢迎页即成功。若打不开,先检查路径是否含中文/空格,再确认php think run是否真在项目根目录(有think文件的那个目录)下执行。
常见失败原因直击
90%的“环境启动失败”其实只因三处细节出错:
- 路径含中文或空格 —— Composer和PHP内部路径解析会崩,必须用C:\tp8、D:\myapp这类路径
- public目录没设为Web根目录 —— 用Apache/Nginx部署时,DocumentRoot或root必须指向project/public,不是项目根目录
- 伪静态规则错用 —— ThinkPHP需专用重写规则(如Nginx里rewrite ^(.*)$ /index.php?s=$1 last;),套Laravel或WordPress规则必然404
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











