ThinkPHP8.0博客项目能跑起来的前提是PHP版本≥8.0且fileinfo、mbstring、openssl、pdo扩展必须启用，缺一则composer安装可能降级或运行时报Class 'think\App' not found；需通过php --ini确认配置文件路径，php -m验证扩展是否真实加载。
ThinkPHP8.0 博客项目能跑起来，前提是本地 PHP 环境版本 ≥ 8.0 且 fileinfo、mbstring、openssl、pdo 这几个扩展必须启用——缺一个，composer create-project 就可能静默降级装 TP6，或者运行时直接报 Class 'think\App' not found。
确认 PHP 版本和扩展是否真就绪
很多人卡在这一步却以为自己“已经装好了”。php -v 显示 8.2 并不等于 ThinkPHP 能用；关键要看命令行实际调用的 PHP 配置路径和启用的扩展。
- 运行
php --ini，确认输出的Loaded Configuration File是你改过的php.ini（不是php.ini-development或php.ini-production） - 运行
php -m | findstr "fileinfo mbstring openssl pdo"（Windows）或php -m | grep -E "fileinfo|mbstring|openssl|pdo"（Mac/Linux），确保每项都出现在列表里 - 如果某扩展没列出来，打开
php.ini，取消对应行的分号注释，例如：extension=fileinfo（注意：Windows 下是.dll，Linux/macOS 下是.so，别写错后缀） - 改完记得重启终端，再验证 —— 环境变量 PATH 指向旧 PHP 目录是 Windows 用户最常忽略的问题
composer create-project 失败的三种典型现场
报错信息往往藏在表象之下。常见失败不是“找不到包”，而是安装中途断掉导致 vendor/autoload.php 缺失，但目录结构看似完整。
-
Failed to open stream: No such file or directory in public/index.php on line 16：90% 是vendor/文件夹没下全。不要删整个项目，进项目上一级目录（如D:\phpEnv\www），重跑：composer create-project topthink/think blog --no-interaction - 卡在
installing dependencies不动：先执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/换国内源，再加-vvv参数看具体哪一步挂了 - 提示
zlib_decode(): data error或解压失败：杀毒软件（尤其是 Windows Defender 实时防护）常拦截composer的临时解压行为，临时禁用试试
启动博客前必须检查的三个路径
ThinkPHP8.0 的入口逻辑和旧版不同，public/ 是唯一 Web 可访问目录，其他路径暴露会引发安全风险或 404。
立即学习“PHP免费学习笔记（深入）”；
- 用内置服务器启动：必须在项目根目录（含
think文件/脚本的位置）执行php think run，不是在public/下，也不是在www/根目录 - 用 Apache/Nginx：DocumentRoot 必须指向
your-blog-path/public，且需开启mod_rewrite（Apache）或配置try_files（Nginx），否则路由全部 404 - Windows 下
php think run报socket_bind failed：不是端口被占，很可能是杀软阻止了 PHP 创建监听 socket，临时关闭防护软件再试
数据库迁移和初始内容怎么加进去
ThinkPHP8.0 博客骨架默认不带数据表和示例文章，得手动补全。
- 先复制
database/migrations/下的迁移文件到你项目的app/database/migrations/（若无此目录需手动建），然后运行php think migrate:run - 如果提示
Command "migrate:run" is not defined，说明没装topthink/think-migration插件，补装：composer require topthink/think-migration - 种子数据（如管理员账号、分类、首篇文章）一般放在
database/seeds/，运行php think seed:run；若该命令不存在，检查是否已启用think-seed扩展 - 所有数据库配置写在
config/database.php，注意'hostname'别写成localhost—— Docker 或某些集成环境需改成127.0.0.1才连得上
真正麻烦的从来不是“怎么装”，而是“哪个环节悄悄用了另一个 PHP 版本”或“扩展看着启了其实没生效”。多跑一遍 php --ini 和 php -m，比重装十次 Composer 更有效。
