README

Simple object oriented wrapper for Packagist API.

Requirements

PHP ^8.2 (for PHP 7.4 please use version ~2.1.0; for PHP 8.0/8.1 please use version ~2.2.0)
A PSR-18 HTTP client and PSR-17 factories. This package doesn't require a specific implementation directly - if your project doesn't already have one, php-http/discovery will automatically install a well-known implementation (e.g. guzzlehttp/guzzle) for you when you require this package. If you'd rather use a specific client, install it yourself before requiring this package, e.g.:

composer require guzzlehttp/guzzle

Installation

The recommended way to install Packagist API is through composer:

composer require knplabs/packagist-api

Usage

Search for packages:

<?php

$client = new Packagist\Api\Client();

foreach ($client->search('sylius') as $result) {
    echo $result->getName();
}

// Outputs:
sylius/sylius
sylius/resource-bundle
sylius/cart-bundle
sylius/flow-bundle
sylius/sales-bundle
sylius/shipping-bundle
sylius/taxation-bundle
sylius/money-bundle
sylius/assortment-bundle
sylius/addressing-bundle
sylius/payments-bundle
sylius/taxonomies-bundle
sylius/inventory-bundle
sylius/settings-bundle
sylius/promotions-bundle
...

You can limit results to a desired amount of pages:

<?php

$client->search('sylius', [], 2)  // get first 2 pages

Get package details:

Gets full package details, generated dynamically by the Packagist API. Consider using getComposer() instead to use the Packagist API more efficiently if you don't need all the full metadata for a package.

<?php

$package = $client->get('sylius/sylius');

printf(
    'Package %s. %s.',
    $package->getName(),
    $package->getDescription()
);

// Outputs:
Package sylius/sylius. Modern ecommerce for Symfony2.

Get composer details: {#get-composer-details}

Similar to get(), but uses Composer metadata which is Packagist's preferred way of retrieving details, since responses are cached efficiently as static files by the Packagist service. The response lacks some metadata that is provided by get(), see Packagist API documentation for details. Returns multiple packages, you need to select the requested one from the indexed array.

<?php

$packages = $client->getComposer('sylius/sylius');
$package = $packages['sylius/sylius'];
$versions = $package->getVersions();

printf(
    'Package %s. %s.',
    $versions[0]->getName(),
    $versions[0]->getDescription()
);

// Outputs:
Package sylius/sylius. Modern ecommerce for Symfony2.

List all packages:

<?php

foreach ($client->all() as $package) {
    echo $package;
}

// Outputs:
abhinavsingh/jaxl
abishekrsrikaanth/fuel-util
abmundi/database-commands-bundle
...

They can be filtered by type or vendor:

<?php

$client->all(array('type' => 'library'));
$client->all(array('vendor' => 'sylius'));

Custom Packagist repositories

You can also set a custom Packagist repository URL:

<?php

$client->setPackagistUrl('https://custom.packagist.site.org');

Custom HTTP client

By default, Client auto-discovers whichever PSR-18 HTTP client and PSR-17 factories are installed in your project, via php-http/discovery. If you need to configure that client yourself (custom middleware, timeouts, auth, etc.), pass your own PSR-18 client instance as the first constructor argument instead:

<?php

use GuzzleHttp\Client as GuzzleClient;

$httpClient = new GuzzleClient(['timeout' => 5]);
$client = new Packagist\Api\Client($httpClient);

Any PSR-18 implementation works here, not just Guzzle.

Errors

A Packagist\Api\PackageNotFoundException will be thrown when the Packagist API returns a 404 response.
An \InvalidArgumentException will be thrown when the response from Packagist was not able to be parsed.

License

packagist-api is licensed under the MIT License - see the LICENSE file for details.

Maintainers

KNPLabs is looking for maintainers (see why).

If you are interested, feel free to open a PR to ask to be added as a maintainer.

We’ll be glad to hear from you :)

This library is maintained by the following people (alphabetically sorted) :

@robbieaverill

knplabs / packagist-api

Package info

Security

Statistics