ThinkPHP开发环境搭建关键在于理清PHP版本与扩展、路径与环境变量、项目启动方式三处卡点。需安装PHP≥8.0并启用mbstring等四个扩展,配置Composer国内镜像,用php think run启动内置服务器。

ThinkPHP搭建开发环境,核心不是堆工具,而是把几个关键环节卡点一次性理清。很多人反复重装、改配置、查报错,其实问题就出在三处:PHP版本与扩展没配齐、路径和环境变量没生效、项目启动方式选错了。下面这些技巧,都是从真实踩坑中提炼出来的实用做法。
PHP安装必须一步到位
别用集成环境“试试看”,ThinkPHP 8 强制要求 PHP ≥ 8.0,且必须启用 mbstring、openssl、pdo_mysql、fileinfo 四个扩展。Windows 用户直接去 windows.php.net 下载 NTS + x64 + VS16 版本(如 php-8.2.12-nts-Win32-vs16-x64.zip),解压到 C:\php8 这类纯英文无空格路径。编辑 php.ini 时只取消这四行前的分号,保存后必须新开命令行窗口再执行 php -v 和 php -m | findstr "mbstring openssl" 双验证。
Composer要配国内镜像再动手
不配镜像,composer create-project 卡住半小时是常态。安装完 Composer 后,立刻执行:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/-
composer config -g allow-plugins true(避免新版 Composer 拒绝加载插件)
之后创建项目才真正“5分钟完成”。注意:项目目录必须为空,命令末尾的 . 不能漏——composer create-project topthink/think .
立即学习“PHP免费学习笔记(深入)”;
启动服务优先用内置服务器
新手别急着配 Apache 或 Nginx。进项目根目录(含 think 文件那层),直接运行:
-
php think run—— 默认监听http://127.0.0.1:8000 - 想换端口?加参数:
php think run -p 8080 - 需要 HTTPS 测试?
php think run --https(自动生成本地证书)
浏览器打开就能看到欢迎页,说明环境已通。后续再考虑虚拟主机或反向代理,不复杂但容易忽略。



















