composer search 命令在 composer 2.2+ 中已彻底移除,因 packagist 官方永久关闭搜索 api,执行必报错“command not defined”;替代方案包括用 curl + jq 调用 packagist api、composer show 验证包、或直接使用 packagist.org 网页搜索。

composer search 命令在 Composer 2.2+ 中已彻底不可用,不是你操作错了,而是 Packagist 官方永久关闭了搜索 API —— 执行会直接报错 Command "search" is not defined。
为什么 composer search 现在会报错
这不是镜像源配置问题、不是命令拼写错误(比如 composersearch 少空格)、也不是没更新 Composer。Packagist 自 2022 年底起下线全文搜索后端服务,Composer 2.2(2023 年发布)起正式删除该命令。你现在看到的报错,是官方主动移除的结果。
如果你刚升级到 Composer 2.2+ 或重装了新版,composer search 就必然失效——没有回滚路径,也没有替代命令内置在核心中。
替代方案:用 curl + jq 调 Packagist API
这是目前最接近原生 composer search 行为的命令行方案,适合快速筛选、CI 脚本或本地查包:
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 基础用法:
curl -s "https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19/search.json?q=log" | jq '.results[] | {name: .name, desc: .description}' | head -n 20 - 必须加
| head -n 20,否则可能刷屏几百条结果 - 关键词支持空格分隔(如
q=cache redis),语义是“同时包含”,但不支持布尔逻辑(AND/OR)或通配符 - 如果提示
jq: command not found,需先安装:brew install jq(macOS)、apt install jq(Ubuntu)或从 jq 官网 下载二进制 - 注意:Packagist API 不走镜像源,所以响应速度和稳定性取决于公网连通性;若你长期用阿里云镜像,这个请求不会命中镜像
更可靠的做法:用 composer show 验证包是否存在
composer show 不是搜索命令,但它能直接反映你当前环境「真实可用」的包——包括是否被废弃、是否有稳定版本、是否兼容你的 PHP 版本:
- 查一个具体包:
composer show monolog/monolog,成功返回说明包存在且未被标记为abandoned - 模糊匹配已知包名前缀:
composer show monolog(不带斜杠)也能命中,但composer show log不会匹配monolog/monolog - 想全局扫一遍再过滤?用:
composer show --all | grep -i "cache",但注意:--all只显示包名和简短描述,不含版本号或 PHP 兼容性信息 - 私有包必须显式指定仓库:
composer show --repository https://your-satis.example.com/packages.json myorg/private-lib,URL 必须是合法的packages.json地址,填 Git URL 或网页地址会报Could not parse version constraint
实际选型时别跳过 Packagist 网页搜索
命令行查得快,但关键决策信息都在网页上:
- 打开 https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19,直接搜关键词(如
queue、psr-7) - 优先看下载量高、最近 6 个月内有更新、GitHub stars 多的包
- 点进详情页,重点检查:
Description是否贴合需求、Keywords是否含你用的技术栈(如laravel、symfony)、abandoned字段是否为true - 翻 GitHub 的
Issues和Recent Commits,判断是否还在活跃维护——很多包搜得到,但最后提交是 3 年前
真正容易被忽略的是:搜到包名 ≠ 能用。PHP 版本兼容性、是否弃用、私有源配置状态,这三件事不手动确认,composer require 时大概率失败。










