Composer安装失败主因是PHP版本过低（TP6需≥7.4，TP8需≥8.1）或openssl/json/mbstring扩展未启用；应检查PHP环境、切换国内镜像源（如阿里云https://mirrors.aliyun.com/composer/）、解决autoload冲突并正确引入自动加载。
Composer 安装失败：PHP 版本或扩展缺失
ThinkPHP 本身不依赖 Composer 运行，但官方推荐用 Composer 创建项目或引入扩展包。安装失败常因本地 PHP 环境不满足 Composer 最低要求（PHP ≥ 7.2.5，且 openssl、json、mbstring 扩展必须启用）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -v确认 PHP 版本；ThinkPHP 6.x 要求 PHP ≥ 7.4，TP 8.x 已要求 PHP ≥ 8.1 - 执行
php -m | grep -E "openssl|json|mbstring"（Linux/macOS）或php -m（Windows）检查扩展是否加载 - 若用 XAMPP/MAMP/WAMP，需在对应控制面板中启用这些扩展，而非仅修改
php.ini - 常见错误信息如
file_get_contents(): SSL operation failed，多因 OpenSSL 未启用或 CA 证书路径异常，可临时加-d openssl.cafile=/path/to/cacert.pem测试
切换国内镜像源：避免 composer install 卡死或超时
默认走 packagist.org，国内直连极慢甚至失败。ThinkPHP 项目里执行 composer create-project 或 composer require 时，镜像源配置直接影响能否顺利拉取 topthink/framework 及其依赖。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 全局切换（推荐）：运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 仅当前项目切换：进入项目根目录后执行
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/ - 验证是否生效：查看
composer.json中是否新增"repositories"字段，或运行composer config repo.packagist输出应为镜像 URL - 注意：阿里云镜像已关闭 HTTP 支持，必须用
https://；清华源偶尔同步延迟，若提示找不到某 dev 分支，可临时切回官方源测试
ThinkPHP 项目中 composer require 报错：autoload 冲突或版本不兼容
在已有 ThinkPHP 项目里引入第三方包（比如 overtrue/wechat 或 league/flysystem-oss），容易因 PSR-4 自动加载规则冲突或主框架版本锁死导致安装失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先查当前 TP 版本：
cat vendor/topthink/framework/src/ThinkPHP.php | grep VERSION或看composer.lock中topthink/framework的 version 字段 - TP 6.0+ 默认使用
psr-4加载，若新包也声明了同名命名空间（如都映射到think\），会触发Class not found—— 此时需手动调整composer.json的autoload-dev或改用classmap - 强制指定兼容版本：
composer require league/flysystem-oss:^2.0（TP 6.1+ 对应 Flysystem 2.x），避免默认装 v3 导致Interface 'League\Flysystem\FilesystemOperator'找不到 - 安装后务必运行
composer dump-autoload -o，否则新类可能不被识别
vendor/autoload.php 引入失败：路径或自动加载机制误用
有些开发者在非标准入口（如手动写的命令行脚本、或 Nginx 静态路由绕过 public/index.php）中直接 require vendor/autoload.php，结果报 Class 'think\Container' not found。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- ThinkPHP 的自动加载不只是靠 Composer，还依赖框架自身的
Loader类注册额外路径（如app/、config/）。单独引入vendor/autoload.php无法加载这些 - 正确做法：统一从
public/index.php入口启动，或仿照它初始化容器：$app = require __DIR__.'/../thinkphp/start.php'; - 若必须独立脚本（如定时任务），应复制
public/index.php结构，至少包含require __DIR__.'/../vendor/autoload.php';+require __DIR__.'/../thinkphp/base.php';+Container::get('app')->run()->send(); - 别把
vendor/autoload.php放进public/目录下直接 Web 访问——这是严重安全风险
镜像源和 autoload 是最常被跳过的两步，但恰恰是 80% 的“装不上”“找不到类”问题的根源。尤其多人协作时，有人用全局镜像，有人没清缓存，composer.lock 就会悄悄不一致。
