thinkphp项目搭建需三步:环境真就绪(验证php扩展加载)、骨架真生成(用create-project而非require)、服务真跑通(php think run并访问欢迎页)。

直接上手,不用等“学完再干”。ThinkPHP 搭建源码项目,核心是三件事:环境真就绪、骨架真生成、服务真跑通。跳过文档堆砌,从命令行敲出第一个欢迎页开始。
确认 PHP 环境真实可用
别只看 php -v 输出版本号——很多失败源于扩展没真正加载或配置没生效。
- 运行
php --ini,确认 Loaded Configuration File 指向你正在修改的php.ini(不是php.ini-development) - 运行
php -m | grep -E "mbstring|openssl|pdo|fileinfo"(Linux/macOS)或php -m | findstr "mbstring openssl pdo fileinfo"(Windows),四项必须全部列出 - 若缺失,打开
php.ini,取消对应extension=行前的分号;Windows 写extension=fileinfo.dll,Linux/macOS 写extension=fileinfo.so - 改完重启终端,再验证;Windows 用户尤其注意 PATH 是否仍指向旧版 PHP 目录
用 create-project 生成完整项目结构
别用 composer require topthink/think ——它只装代码包,不建目录结构,必然报 Class 'think\App' not found。
- 先切国内镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 执行:
composer create-project topthink/think blog(自动拉最新稳定版) - 如需指定版本防意外降级:
composer create-project topthink/think blog 8.1.5 - 完成后进入目录:
cd blog,所有后续命令都在此目录下执行
启动服务并验证首页可访问
能执行 php think run ≠ 能看到页面。关键在入口是否走对、public 是否被正确识别。
- 在项目根目录运行:
php think run,看到http://127.0.0.1:8000提示即表示服务已启 - 浏览器打开该地址,显示 “ThinkPHP V8.x” 欢迎页才算真正成功
- 若 404 或空白,检查:是否在
blog目录下执行、public/index.php是否存在、.env中APP_DEBUG=true是否开启 - 快速验证路由链路:
php think make:controller Api/Hello,编辑方法返回json(['msg'=>'OK']),再访问http://127.0.0.1:8000/api/hello
部署到服务器前的关键准备
本地跑通只是第一步。上传前这几步不做,上线大概率白屏或报错。
- 删掉本地
runtime/全部内容(缓存文件不兼容服务器环境) - 确保
.env中APP_DEBUG=false(生产环境必须关闭调试) - 上传时只传
app/、config/、public/、vendor/等必要目录,runtime/和vendor/不传(服务器上重新生成) - 上传后,在服务器项目根目录执行:
composer install --no-dev --optimize-autoloader - Web 服务器根目录必须设为
public/(不是项目根目录),Nginx 写root /path/to/blog/public;,Apache 设DocumentRoot指向 public
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











