Files
wehub-resource-sync 9b395f5cc3
E2E Headed Chrome / e2e-headed (macos-15) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (ubuntu-latest) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (windows-latest) (push) Has been cancelled
CI / build (macos-latest) (push) Has been cancelled
CI / build (ubuntu-latest) (push) Has been cancelled
CI / build (windows-latest) (push) Has been cancelled
CI / unit-test (push) Has been cancelled
CI / bun-test (push) Has been cancelled
CI / adapter-test (push) Has been cancelled
CI / smoke-test (macos-latest) (push) Has been cancelled
CI / smoke-test (ubuntu-latest) (push) Has been cancelled
Security Audit / audit (push) Has been cancelled
Build Chrome Extension / build (push) Has been cancelled
Trigger Website Rebuild (Docs Updated) / dispatch (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:39:48 +08:00

65 lines
2.2 KiB
Markdown

# Packagist
**Mode**: 🌐 Public · **Domain**: `packagist.org`
Search and inspect PHP / Composer packages on Packagist without auth or browser. Two commands.
## Commands
| Command | Description |
|---------|-------------|
| `opencli packagist search <query>` | Search Packagist (PHP / Composer) packages by keyword |
| `opencli packagist package <name>` | Single-package metadata (version, downloads, license, repo, GitHub stars) |
## Usage Examples
```bash
# Search packages
opencli packagist search symfony --limit 10
opencli packagist search "laravel http" --limit 5
# Single-package metadata (use `package` from search rows; vendor/package required)
opencli packagist package symfony/console
opencli packagist package laravel/framework
opencli packagist package monolog/monolog
# JSON output
opencli packagist search symfony -f json
opencli packagist package symfony/console -f json
```
## Output Columns
| Command | Columns |
|---------|---------|
| `search` | `rank, package, description, downloads, favers, repository, url` |
| `package` | `package, version, releasedAt, license, description, repository, githubStars, favers, downloads, monthlyDownloads, dailyDownloads, url` |
The `package` column from `search` round-trips into `package` exactly.
## Options
### `packagist search`
| Option | Description |
|--------|-------------|
| `query` (positional) | Search keyword |
| `--limit` | Max packages (1-100, default: 30) |
### `packagist package`
| Option | Description |
|--------|-------------|
| `name` (positional) | Composer package `<vendor>/<package>` (`symfony/console`, `monolog/monolog`) |
## Caveats
- Composer names are validated upfront — both `vendor` and `package` segments are required, lowercase letters / digits / `_-.` only, max 100 chars per segment. Bad input raises `ArgumentError`.
- `version` is the newest stable release (skipping `*-dev`, `*-rc*`, `*-beta*`, `*-alpha*`). Falls back to the newest available version if no stable exists.
- `releasedAt` is normalized to second-precision `YYYY-MM-DDTHH:MM:SSZ`.
- Packagist throttles bursts; `HTTP 429` surfaces as a typed `CommandExecutionError` with a retry hint.
## Prerequisites
- No browser required — uses `packagist.org/search.json` and `packagist.org/packages/<vendor>/<package>.json`.