Composer安装ThinkPHP5扩展本质是安装符合PSR-4规范的第三方包，非中心化插件市场；装不上常见因未发布至Packagist、autoload未正确声明PSR-4映射或依赖版本不兼容。

Composer 安装 ThinkPHP 5 扩展插件，本质是安装符合 PSR-4 自动加载规范的第三方包，不是“TP5 插件市场”式安装——TP5 本身没有中心化插件体系，所有扩展都走标准 Composer 包流程。

为什么 composer require 装不上某些“TP5 插件”？

常见原因有三个：

• 该包未发布到 Packagist，也未在 composer.json 中配置私有仓库（repositories）
• 包的 autoload 没正确声明 PSR-4 映射，导致 TP5 的 Loader 找不到类（例如写成 "psr-4": {"": "src/"} 却没带命名空间前缀）
• 包依赖了不兼容的 PHP 或 ThinkPHP 版本，而 composer require 默认拒绝降级或跳过约束（可通过 --ignore-platform-reqs 强行装，但不推荐）

composer.json 中必须确认的 TP5 兼容项

旧版 ThinkPHP 5.0.x 和 5.1.x 对 Composer 的要求差异较大，容易因配置错位导致自动加载失败：

• TP5.0 使用自己的 thinkphp/library/think/Loader.php，只支持 psr-4 和 classmap，不识别 files 类型的全局函数加载
• TP5.1+ 已完全切换为 Composer 原生 autoloader，支持 files，但需确保包的 autoload.files 指向的是可直接 require 的 PHP 文件（如 functions.php）
• 务必检查扩展包的 composer.json 中 require 字段是否含 "topthink/framework": "^5.0" 或 "^5.1"，版本号不匹配会导致 Composer 拒绝安装

手动注册非 Packagist 包（如 GitHub 仓库）

很多 TP5 扩展只托管在 GitHub，没提交到 Packagist。此时不能只靠 composer require vendor/name，必须显式添加仓库源：

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/username/think-wechat"
        }
    ],
    "require": {
        "username/think-wechat": "dev-master"
    }
}

注意点：

• url 必须是 Git 仓库地址，且该仓库根目录下要有合法的 composer.json
• require 中的包名（username/think-wechat）必须与目标仓库 composer.json 里的 name 字段完全一致
• 分支名写 dev-master 或 dev-develop 时，Composer 默认不更新 —— 需加 --prefer-source 或删掉 vendor 后重装

装完后还要手动加载？

绝大多数正规扩展包装完即用，但以下两类情况需要额外操作：

• 提供命令行指令（如 php think optimize:route）的包，需确认其 composer.json 中 extra.think-command 是否已注册，否则 php think 不识别新命令
• 含服务提供者（Service Provider）的包（如 think-swoole），需在 application/provider.php 中手动追加类名，TP5 不自动扫描 providers 数组
• 使用 files 加载辅助函数的包（如 topthink/think-helper），仅 TP5.1+ 支持，TP5.0 会静默忽略 —— 此时得改用 Loader::addNamespace() 手动注册

最常被忽略的一点：TP5 的自动加载缓存（runtime/cache/ 下的 autoload_*.php）不会随 composer install 自动刷新。装完新包后，务必清空 runtime/cache/ 目录，否则旧类映射仍生效，新类报 Class not found。