Download the PHP package calliostro/discogs-bundle without Composer

Discogs API Bundle for Symfony

A Symfony bundle integrating calliostro/php-discogs-api into your Symfony application. Provides dependency injection, autowiring, built-in retry resilience, and optional rate limiting for PHP 8.1+ and Symfony 6.4, 7.x, and 8.x.

📦 Installation

Install via Composer:

⚙️ Configuration

Configure the bundle in config/packages/calliostro_discogs.yaml:

[!NOTE] By default, the client uses DiscogsClient/4.1.0 (+https://github.com/calliostro/php-discogs-api) as User-Agent. You can override this in the configuration if needed.

Authentication Methods

• Personal Access Token: Obtain your token from Discogs Developer Settings to access user-specific data (collections, wantlists) and benefit from higher rate limits (60 requests/min).
• Consumer Credentials: For OAuth applications, register your application on Discogs to obtain your consumer_key and consumer_secret.
• Anonymous Access: If no credentials are configured, the bundle initializes the client for public data endpoints (subject to unauthenticated rate limits of 25 requests/min).

🚀 Quick Start

Basic Usage

Inject the DiscogsClient service directly into your controllers or services:

Collection and Wantlist

Search and Database Lookups

✨ Key Features

• Lightweight Integration – Minimal footprint with zero overhead on top of calliostro/php-discogs-api.
• Complete API Coverage – All 60 Discogs API endpoints supported.
• Direct API Calls – $client->getArtist(artistId: 123) maps directly to /artists/{id}.
• Built-in Retry Resilience – Automatic exponential backoff and retry handling for 429 Too Many Requests and 503 Service Unavailable responses.
• Type Safe & IDE Support – PHP 8.1+ types, named parameters, and PHPStan Level 8 static analysis.
• Symfony Native – Autowiring support for Symfony 6.4, 7.x, and 8.x.
• Multiple Authentication Methods – Personal Access Token, OAuth 1.0a, Consumer Credentials, and Anonymous access.

🎵 All Discogs API Methods as Direct Calls

• Database Methods – search(), getArtist(), listArtistReleases(), getRelease(), getUserReleaseRating(), updateUserReleaseRating(), deleteUserReleaseRating(), getCommunityReleaseRating(), getReleaseStats(), getMaster(), listMasterVersions(), getLabel(), listLabelReleases()
• User Identity Methods – getIdentity(), getUser(), updateUser(), listUserSubmissions(), listUserContributions()
• User Collection Methods – listCollectionFolders(), getCollectionFolder(), createCollectionFolder(), updateCollectionFolder(), deleteCollectionFolder(), listCollectionItems(), getCollectionItemsByRelease(), addToCollection(), updateCollectionItem(), removeFromCollection(), getCustomFields(), setCustomFields(), getCollectionValue()
• User Wantlist Methods – getUserWantlist(), addToWantlist(), updateWantlistItem(), removeFromWantlist()
• User Lists Methods – getUserLists(), getUserList()
• Marketplace Methods – getUserInventory(), getMarketplaceListing(), createMarketplaceListing(), updateMarketplaceListing(), deleteMarketplaceListing(), getMarketplaceFee(), getMarketplaceFeeByCurrency(), getMarketplacePriceSuggestions(), getMarketplaceStats(), getMarketplaceOrder(), getMarketplaceOrders(), updateMarketplaceOrder(), getMarketplaceOrderMessages(), addMarketplaceOrderMessage()
• Inventory Export Methods – createInventoryExport(), listInventoryExports(), getInventoryExport(), downloadInventoryExport()
• Inventory Upload Methods – addInventoryUpload(), changeInventoryUpload(), deleteInventoryUpload(), listInventoryUploads(), getInventoryUpload()

[!NOTE] Complete method documentation and endpoint parameters can be found in the Discogs API Documentation.

📋 Requirements

• PHP ^8.1 (tested on PHP 8.1–8.6)
• Symfony ^6.4 || ^7.0 || ^8.0
• calliostro/php-discogs-api ^4.1

⚡ Resilience & Rate Limiting

Built-in Retries (Reactive)

Out of the box, calliostro/php-discogs-api v4.1 automatically handles rate limit responses (429 Too Many Requests) and temporary service downtime (503 Service Unavailable). When triggered, the client sleeps for the duration requested by Discogs (via the Retry-After header) or uses exponential backoff before retrying the request.

You can customize or disable this behavior in config/packages/calliostro_discogs.yaml:

Symfony Rate Limiter (Proactive, Optional)

For high-volume batch processing, background workers, or scraping tasks, use symfony/rate-limiter to throttle outgoing requests client-side before sending them:

1. Configure the Rate Limiter

2. Assign to the Bundle

🧪 Development & Testing Guide

See DEVELOPMENT.md for detailed setup instructions, test suite commands, static analysis, and contribution guidelines.

🤝 Contributing

Contributions are welcome! Please ensure that all tests pass and coding standards are maintained:

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

⚖️ Disclaimer

Discogs is a registered trademark of Zink Media, LLC. This project is an independent, unofficial open-source library and is not affiliated with, endorsed by, or sponsored by Discogs or Zink Media, LLC.

🙏 Acknowledgments

• Discogs for providing the database and API.
• Symfony for the web framework and dependency injection container.
• Underlying client: calliostro/php-discogs-api.
• Sister Symfony bundles: calliostro/spotify-web-api-bundle, calliostro/last-fm-client-bundle, and calliostro/musicbrainz-bundle.