🚀 安装与使用

如何获取并运行 composer-skills CLI 工具。

前置要求

• 📦 远程 Packagist 命令：仅需 composer-skills 二进制，无需 PHP。
• 🛠️ 本地 local 命令组：需要本机已安装 PHP 7.4+ 与 Composer 2.0+（或让 SDK 自动安装，见 自动安装机制）。

方式一：go install

go install github.com/scagogogo/composer-skills/cmd/composer-skills@latest

安装到 $GOPATH/bin（确保该目录在 PATH 中）。

方式二：从源码构建

git clone https://github.com/scagogogo/composer-skills.git
cd composer-skills
make build          # 产物在 bin/composer-skills
# 或
go build -o composer-skills ./cmd/composer-skills

仓库根目录也提供 build.sh 脚本：

./build.sh          # 输出到 build/ 目录

方式三：Docker

项目自带 Dockerfile 与 docker-compose.yml：

docker build -t composer-skills .
docker run --rm composer-skills search query "logging"

详见 Docker 部署。

验证安装

composer-skills --help

应输出根命令与子命令列表。

常用工作流

查询远程包信息

# 搜索
composer-skills search query "psr log"

# 详情
composer-skills package info psr/log

# 统计
composer-skills repo stats

# 热门包
composer-skills repo popular

安全检查

# 全局安全公告
composer-skills security advisories

# 某个包的公告
composer-skills security package monolog/monolog

本地项目操作

在 PHP 项目目录下：

composer-skills local install              # 安装依赖
composer-skills local require monolog/monolog "^3.0"
composer-skills local update
composer-skills local audit                # 安全审计
composer-skills local validate-lock        # 验证 lock 文件
composer-skills local project-info         # 项目信息

JSON 输出（供脚本消费）

composer-skills package info monolog/monolog --json | jq .

配置认证（管理类命令）

manage create/edit/update 需要 Packagist API 凭证：

composer-skills manage create \
  --username YOUR_USERNAME \
  --api-token YOUR_TOKEN \
  --json

进阶

• 完整子命令清单见 CLI 概览。
• 在 CI/CD 中使用见 CI/CD 流水线。
• 本地命令对应的 Go SDK 见 Composer CLI SDK。