Download the PHP package calliostro/discogs-bundle without Composer

⚡ Discogs Client Bundle for Symfony – Complete Music Database Access

🚀 SYMFONY INTEGRATION! Seamless autowiring for the complete Discogs music database API. Zero bloat, maximum performance.

Symfony bundle that integrates the modern calliostro/php-discogs-api into your Symfony application. Built with modern PHP 8.1+ features, dependency injection, and powered by Guzzle.

📦 Installation

Install via Composer:

⚙️ Configuration

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

Personal Access Token: You need to get your token from Discogs to access your account data and get higher rate limits. For read-only operations on public data, you can use anonymous access.

Consumer Credentials: For building applications that need OAuth authentication, register your app at Discogs to get your consumer key and secret.

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

🚀 Quick Start

Basic Usage

Collection and Wantlist

Search and Discovery

✨ Key Features

• Ultra-Lightweight – Minimal Symfony integration with zero bloat for the ultra-lightweight Discogs client
• Complete API Coverage – All 60 Discogs API endpoints supported
• Direct API Calls – $client->getArtist(id: 123) maps to /artists/{id}, no abstractions
• Type Safe + IDE Support – Full PHP 8.1+ types, PHPStan Level 8, method autocomplete
• Symfony Native – Seamless autowiring with Symfony 6.4, 7.x & 8.x
• Well Tested – Comprehensive test coverage, Symfony coding standards
• Multiple Auth Methods – Personal Access Token, OAuth 1.0a, Consumer Credentials, Anonymous

🎵 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()

All 60 Discogs API endpoints are supported with clean documentation — see Discogs API Documentation for complete method reference

📋 Requirements

• php ^8.1
• symfony ^6.4 | ^7.0 | ^8.0
• calliostro/php-discogs-api ^4.0

🔧 Service Integration

⚡ Rate Limiting (Optional)

For high-volume applications, use the powerful symfony/rate-limiter component:

1. Configure Rate Limiter

2. Configure Bundle

Choose your rate limit based on your authentication:

• Anonymous access: Use 25/min (as shown above)
• Authenticated only: Change limit to 60 for maximum performance

The bundle uses a Guzzle middleware that automatically handles rate limiting by:

• Intercepting outgoing requests before they're sent
• Checking rate limit availability using Symfony's RateLimiter
• Automatically waiting when limits are exceeded (using microsecond precision)
• Retrying requests after the appropriate delay

This seamless integration ensures your application never exceeds API limits without requiring any code changes. Higher rates may result in HTTP 429 responses if rate limiting is not configured.

🤝 Contributing

Contributions are welcome! Please see DEVELOPMENT.md for detailed setup instructions, testing guide, and development workflow.

📄 License

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

🙏 Acknowledgments

• Discogs for providing the excellent music database API
• Symfony for the robust framework and DI container
• calliostro/php-discogs-api for the modern client library

⭐ Star this repo if you find it useful! It helps others discover this lightweight solution.