markwalet / laravel-packagist
A Laravel wrapper for the `spatie/packagist-api` package.
Fund package maintenance!
markwalet
www.paypal.me/markwalet
Installs: 1 592
Dependents: 0
Suggesters: 0
Security: 0
Stars: 13
Watchers: 2
Forks: 1
Open Issues: 0
Requires
- php: ^8.1
- ext-json: *
- laravel/framework: ^10.0|^11.0
- phpoption/phpoption: >=1.8
- spatie/packagist-api: ^2.0
Requires (Dev)
- orchestra/testbench: 8.*|9.*
- phpunit/phpunit: ^10.5
This package is auto-updated.
Last update: 2024-11-05 18:13:45 UTC
README
A Laravel wrapper for the spatie/packagist-api package.
Installation
You can install this package with composer:
composer require markwalet/laravel-packagist
Laravel uses Package auto-discovery, so you don't have to register the service provider. If you want to register the service provider manually, add the following line to your config/app.php
file:
MarkWalet\Packagist\PackagistServiceProvider::class,
Usage
There are two main ways how you can make Packagist calls:
Using the application container
/** @var \Spatie\Packagist\PackagistClient $client */ $client = app(\Spatie\Packagist\PackagistClient::class); $client->getPackage('markwalet', 'laravel-packagist');
Using the facade
Packagist::getPackage('markwalet', 'laravel-packagist');
Available methods
List package names
// All packages Packagist::getPackagesNames(); // Filter on type. Packagist::getPackagesNamesByType('composer-plugin'); // Filter on organization Packagist::getPackagesNamesByVendor('markwalet');
Searching for packages
// Search packages by name. Packagist::searchPackagesByName('packagist'); // Search packages by tag. Packagist::searchPackagesByTags('psr-3'); // Search packages by type. Packagist::searchPackagesByType('composer-plugin'); // Combined search. Packagist::searchPackages('packagist', ['type' => 'library']);
Pagination
Searching for packages returns a paginated result. You can change the pagination settings by adding more parameters.
// Get the third page, 10 items per page. Packagist::searchPackagesByName('packagist', 3, 10);
Getting package data.
// Using the Composer metadata. (faster, but less data) Packagist::getPackageMetadata('markwalet/laravel-packagist'); Packagist::getPackageMetadata('markwalet', 'laravel-packagist'); // Using the API. (slower, cached for 12 hours by Packagist. Packagist::getPackage('markwalet/laravel-packagist'); Packagist::getPackage('markwalet', 'laravel-packagist');
Get Statistics
$packagist->getStatistics();
Configuration
By default, the api url for Packagist is set to https://packagist.org
. If you want to override that, you can add the following code block to your config/services.php
file:
'packagist' => [ 'base_url' => 'https://packagist.org', 'repo_url' => 'https://repo.packagist.org', ],