composer search命令在2.2+中已彻底移除，报错“command not defined”是因packagist自2022年底关闭搜索api所致；替代方案为curl调用https://packagist.org/search.json?q=关键词，并配合composer show验证兼容性。
composer search 命令在 Composer 2.2+ 中已彻底移除，任何“结果太多”的问题都不存在——它根本不能用。你现在看到的报错 command "search" is not defined 不是配置问题，是功能被删了。真要查包，得换路径。
为什么 composer search 会失败或返回空
packagist.org 自 2022 年底关闭了搜索 API，Composer 2.2（2023 年发布）起直接删掉 search 命令。哪怕降级到 1.x，返回结果也极简、无分页、不带描述，实际不可靠。
常见错误现象：
- 敲
composer search log报错command "search" is not defined - 加
--only-name或多关键词，照样报错或无输出 - 误以为是镜像源没切对，其实换源也没用
用 curl + jq 直调 Packagist 搜索接口
这是目前唯一能拿到结构化搜索结果的方式，支持关键词、过滤字段、快速预览：
- 基础搜索：
curl -s "https://packagist.org/search.json?q=cache" - 带格式化（需安装
jq）：curl -s "https://packagist.org/search.json?q=log" | jq '.results[] | {name: .name, desc: .description}' - 只看前 5 个：
curl -s "https://packagist.org/search.json?q=redis" | jq '.results[0:5] | map({name: .name, type: .type})'
注意：该接口最多返回 10 条，不支持分页；想多看几个包，只能换词重试（比如试 cache adapter 而非仅 cache）。
CurlShip Directory Submission
下载
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
查完远程，再用 show -s 和 show --all 验证本地兼容性
搜到包名只是第一步，关键得确认它能在你当前环境装得上、跑得通：
- 查是否与当前 PHP 版本/扩展兼容：
composer show -s vendor/package-name（显示 require 约束和平台要求） - 查是否已安装且含 keywords 描述：
composer show --all | grep -A 5 "package-name"（--all输出完整字段，含keywords、type、description） - 查有没有本地版本冲突：
composer prohibits vendor/package-name:^3.0（看谁挡了升级路）
keywords 是 composer.json 里静态定义的数组，不是运行时生成的，所以它影响 packagist 搜索排序，但不反映真实兼容性——别光看 keywords 就拍板。
grep 过滤依赖树时容易缩进错乱
用 composer show --tree | grep -A 5 -B 5 "guzzle" 看层级时，终端宽度不够会导致缩进被截断，误判依赖深度。更稳的做法是：
- 先用
composer show --tree | less -S（-S禁止自动换行，左右滑动看全缩进） - 用
grep -E "^ {0,4}guzzlehttp/"匹配特定缩进层级（比如 0–4 个空格开头的行），比单纯grep "guzzle"更准 - 遇到中文包名或特殊字符导致缩进不对齐？改用
composer show --tree | awk '/guzzlehttp\/psr7/{for(i=NR-2;i（取上下两行）
真正难的不是找到包，而是确认它是否被你的代码调用、是否在 autoload 映射里、是否被其他包硬依赖着——这些 grep 看不到，得靠 composer depends 和 grep -r 配合验证。
