composer search 命令在 Composer 2.2+ 中已被彻底移除,因 Packagist 自2022年底关闭全文搜索 API,官方明确不恢复;替代方案是用 curl 调用 Packagist 搜索 API 或依赖 composer show。

composer search 命令在 Composer 2.2+ 中已彻底移除,执行会直接报错:Command "search" is not defined。这不是你环境配置问题,而是 Packagist 官方停用了全文搜索 API,Composer 主动废弃了该功能。
为什么 composer search 现在不能用了
Packagist 自 2022 年底起关闭了公开的全文搜索接口,旧版 Composer(≤2.1)依赖的后端服务也已下线。官方明确表示:不再恢复,也不提供替代命令。
- 不是镜像源没切对,也不是网络问题——即使直连
packagist.org也查不到 -
composer search在 2.2+ 版本中已被硬编码移除,源码里连对应 Command 类都删了 - 试图用
composer self-update回退到 2.1 是高风险操作:PHP 8.2+ 兼容性差,且无法安装新版安全补丁
替代方案一:用 curl 直调 Packagist 搜索 API
这是目前最轻量、无需额外 PHP 工具、结果最贴近原始 search 行为的方式。
- 基础用法:
curl -s "https://packagist.org/search.json?q=cache" | jq '.results[] | {name: .name, desc: .description}' - 不装
jq?至少加| head -n 20看前几条,避免刷屏 - 关键词支持空格“与”逻辑(如
q=cache redis),但不支持引号短语匹配或布尔运算 - 注意限流:未带
User-Agent或高频请求(
替代方案二:用 composer show 和 --dry-run 验证真实可用性
与其搜一堆“理论上存在”的包,不如直接验证它能不能真正在你项目里装上。
- 查包是否存在、是否活跃:
composer show monolog/monolog
—— 成功返回即说明可解析,失败提示Package not found - 模拟安装,检查 PHP 版本/依赖冲突:
composer require --dry-run phpunit/phpunit:^9
—— 不改composer.json,但完整走一遍依赖解析 - 想批量试多个包?写个 shell 循环:
for pkg in "psr/log" "symfony/http-foundation"; do echo "== $pkg =="; composer show "$pkg" 2>/dev/null | head -n 3; done
别再依赖 Packagist 网页手动搜
网页看似信息全,但开发时容易踩三个隐形坑:
- 不标
abandoned状态:比如搜guzzlehttp/ringphp,网页仍显示,实际早已被弃用多年 - 版本列表无上下文:显示所有历史 tag,但不会告诉你
php: ^8.3下唯一能装的是v2.5.0而非最新v3.x - 复制包名易出错:网页点击复制常带多余空格或换行,
symfony/console(末尾空格)会导致require失败
真正省时间的做法,是把 curl + jq 封成 alias,或者干脆只信 composer show 的输出——毕竟最终要敲进 require 的,不是网页标题。










