🔍 SearchPackages

通过关键词搜索 Packagist 上的包，支持分页。

何时使用

🔍 在包选择器 / IDE 插件中按关键词找包；📊 对比多个候选包的下载量与收藏数；🧭 用户输入自由文本时的模糊查找。

签名

func (c *ComposerClient) SearchPackages(query string, perPage, page int) (*domain.SearchResponse, error)

参数

参数	类型	说明
query	string	搜索关键词，如 http client
perPage	int	每页结果数；传 0 或负数则不带 per_page 参数（用端点默认值）
page	int	页码；传 0 或负数则不带 page 参数

返回值

值	类型	说明
结果	*domain.SearchResponse	Results 为 []SearchResult（含 name/description/url/repository/downloads/favers），Total 为总数，Next 为下一页 URL
错误	error	HTTP 失败、非 200、JSON 解析失败时返回

对应端点：GET https://packagist.org/search.json?q={query}。

示例

package main

import (
	"fmt"
	"log"
	"time"

	"github.com/scagogogo/composer-skills/pkg/client"
)

func main() {
	c := client.NewComposerClient(30 * time.Second)

	resp, err := c.SearchPackages("http client", 15, 1)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("结果总数: %d\n", resp.Total)
	for i, r := range resp.Results {
		fmt.Printf("%2d. %s (下载 %d, 收藏 %d)\n", i+1, r.Name, r.Downloads, r.Favers)
	}
}

进阶

• 🏷️ 按标签搜索用 SearchPackagesByTags。
• 🧩 按类型 + 关键词搜索用 SearchPackagesByType。
• 📦 拿到包名后取完整详情用 GetPackage。