🧩 SearchPackagesByType

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

何时使用

🧩 只在特定类型（如 composer-plugin）里搜索关键词；🏗️ 按类型 + 功能组合发现包；🎯 比通用搜索更精确地缩小候选范围。

签名

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

参数

参数	类型	说明
query	string	搜索关键词，如 installer
packageType	string	包类型，如 composer-plugin、library
perPage	int	每页结果数；传 0 或负数则不带 per_page 参数
page	int	页码；传 0 或负数则不带 page 参数

返回值

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

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

示例

package main

import (
	"fmt"
	"log"
	"time"

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

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

	resp, err := c.SearchPackagesByType("installer", "composer-plugin", 15, 1)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("结果总数: %d\n", resp.Total)
	for i, r := range resp.Results {
		fmt.Printf("%2d. %s — %s\n", i+1, r.Name, r.Description)
	}
}

进阶

• 🔍 只按关键词搜索（不限类型）用 SearchPackages。
• 🏷️ 按标签搜索用 SearchPackagesByTags。
• 📋 只列某类型全部包名（不带关键词）用 ListPackagesByType。