Last Fm Client Bundle Laravel Package

Added

• Upgraded dependency to calliostro/lastfm-client v2.1 with built-in retry resilience on Last.fm rate limits (429) and server overload (503).
• Added auto_retry (default true) and max_retries (default 3) configuration options in calliostro_lastfm.
• Added unit tests for new retry configuration and extension options maintaining 100% code coverage.
• Compatibility testing and CI matrix coverage for PHP 8.1–8.6 and Symfony 6.4 LTS, 7.x, 8.0, 8.1, and 8.2.
• Created root phpstan.neon.dist (Level 8) and migrated .php-cs-fixer.php to .php-cs-fixer.dist.php (PSR-12 rules).

Changed

• Updated GitHub Actions runners to ubuntu-24.04 and modernized action versions to Node 24 compatible runners (actions/checkout@v7, actions/cache@v6, codecov/codecov-action@v7).
• Overhauled README and documentation tone, adopting native GitHub Markdown alerts, backtick method formatting, and sister bundle links.
• Updated Composer scripts (cs, cs-fix, analyse).

Complete rewrite of the Symfony bundle providing seamless integration with the modern Last.fm client library.

Breaking Changes

• New Dependency: Requires calliostro/lastfm-client v2.0.0 (replaces calliostro/php-lastfm-api)
• Namespace Update: Service class uses Calliostro\LastFm\LastFmClient (capital F in LastFm)
• Configuration: New YAML structure under calliostro_lastfm key
• Autowiring: Full support for constructor injection and type-hinted parameters

Migration Required

Existing v1.x installations must update configuration and service references. See UPGRADE.md for detailed migration guide.

Features

• Seamless autowiring support for LastFmClient
• Built-in rate limiting with symfony/rate-limiter integration
• Comprehensive test coverage (100%)
• PHP 8.1 - 8.5 compatibility
• Symfony 6.4, 7.x, 8.x support
• PHPStan Level 8 compliance

Documentation

• README
• Migration Guide
• Development Guidelines
• Changelog

Major Release – Complete Architecture Modernization

🚀 Breaking Changes

• New dependency: Migrated from snapshotpl/last-fm-client to calliostro/lastfm-client • Configuration structure: Updated service configuration and factory patterns • PHP 8.1+ required: Modernized codebase with current PHP standards

✨ New Features

• Modern Client Library: Built on calliostro/lastfm-client v1.0.0 • Enhanced Configuration: Automatic API key and secret validation • Symfony Flex Ready: Install with composer require calliostro/last-fm-client-bundle

🔧 Technical Updates

• PHP 8.1-8.4 & Symfony 6.4-7.x Support: Current version compatibility • Modern Architecture: Clean dependency injection with factory patterns • Comprehensive Testing: Enhanced CI/CD with full test matrix coverage

🔗 Migration

• Legacy Support: v0.4.x continues on legacy/0.x branch • Upgrade Guide: See UPGRADE.md for migration from v0.4.x to v1.0.0

Modern foundation for the 1.x series with maintainable architecture.

This is the final maintenance release for the 0.x branch supporting snapshotpl/last-fm-client.

🔧 Maintenance Updates

• Documentation Improvements: Enhanced README with clear migration guidance to v1.0.0 • CI Badge Corrections: Fixed coverage and build status badges for proper branch references
• Branch Organization: Clear distinction between legacy (legacy/0.x) and modern (main) branches • Code Quality: Minor improvements and consistency fixes

📋 Important Notes

• 🚨 Final Version: Last release with snapshotpl/last-fm-client support • Legacy Maintenance Mode: Only security and PHP/Symfony compatibility updates • New Projects: Use version ^1.0 with modern calliostro/lastfm-client architecture • Existing Projects: Stay on ^0.4.3 for continued legacy support

🛠️ Technical Details

• Continued Compatibility: PHP 8.1-8.4 and Symfony 6.4-7.x support maintained • Stable Foundation: Production-ready with proven snapshotpl/last-fm-client integration • Security Updates: Will receive critical security patches as needed

This marks the end of active feature development for the 0.x branch. All future development focuses on the 1.x series with modern architecture.

This is the final maintenance release for the 0.x branch supporting snapshotpl/last-fm-client.

🔧 Maintenance Updates

• Continued maintenance and compatibility updates for snapshotpl/last-fm-client
• Enhanced CI/CD pipeline with PHP 8.5 and Symfony 8.0 support
• Improved documentation and branch organization
• Code quality improvements based on automated reviews

📋 Important Notes

• 🚨 Final version with snapshotpl/last-fm-client support
• Legacy maintenance mode: Only PHP/Symfony compatibility updates, no new features
• For new projects: Use version ^1.0 with modern calliostro/lastfm-client from the main branch
• For existing projects: Stay on ^0.4 if migration to v1.0 is not desired

🛠️ Technical Details

• Enhanced CI matrix for future PHP/Symfony versions
• Improved code documentation and maintainability
• Branch-specific documentation and badges

This marks the end of active development for the 0.x branch. Future development will focus on the 1.x series.

🔄 CI/CD Migration Migrated continuous integration from Travis CI to GitHub Actions for improved reliability, faster builds, and better GitHub ecosystem integration. This builds upon the enhanced package metadata and dependencies introduced in v0.4.0.

📋 What's Changed:

• ✅ GitHub Actions CI with comprehensive PHP 8.1-8.5 testing matrix
• ✅ Symfony compatibility testing for versions 6.4 (LTS), 7.x, and 8.x
• ✅ Updated README badge pointing to GitHub Actions instead of Travis CI
• ✅ Maintained compatibility with all existing PHP and Symfony versions

🔗 Previous Release: See v0.4.0 for the latest package description, keyword enhancements, and dependency updates.

🛠️ Technical Details:

• Automated testing across multiple PHP/Symfony combinations
• Improved build reliability and faster feedback cycles
• Full backward compatibility maintained

🚀 Breaking Changes

• PHP 8.1+ required - Dropped support for PHP 7.3, 7.4, and 8.0
• Symfony 6.4+ required - Dropped support for Symfony 5.x

✨ New Features

• Full PHP 8.1-8.5 support - Including preparation for upcoming PHP 8.5
• Symfony 6.4 LTS support - Full compatibility with current LTS version
• Symfony 7.x support - Ready for all Symfony 7 releases including 7.4 LTS
• Symfony 8.x support - Future-proof with upcoming Symfony 8 releases

🔧 Improvements

• Modernized CI/CD pipeline - Comprehensive test matrix covering all supported PHP and Symfony versions
• Updated PHPUnit configuration - Using modern PHPUnit 9.6 features and schema
• Enhanced documentation - Improved README with emojis, better structure, and clearer instructions
• Cleaner development environment - Refined .gitignore patterns
• Added composer scripts - composer test command for easy testing

🛠 Technical Updates

• Dependencies updated to latest stable versions compatible with new requirements
• Test suite improvements - Randomized execution order for better reliability
• Improved deprecation handling in test environment
• Better coverage reporting configuration with modern PHPUnit elements
• Enhanced type safety - Added return types and improved type hints throughout codebase

📚 Documentation

• Updated installation and configuration examples with modern PHP 8.1+ patterns
• Added comprehensive upgrade guide (UPGRADE.md)
• Modern code examples using PHP 8 attributes instead of annotations
• Enhanced with emoji-driven sections for better readability
• Security best practices - Environment variable handling recommendations

Upgrade is easy: Update your PHP to 8.1+ and Symfony to 6.4+, run composer update, and you're ready to go!

For detailed upgrade instructions, see UPGRADE.md.

Full Changelog: https://github.com/calliostro/last-fm-client-bundle/compare/v0.2.0...v0.3.0

• Get a Last.fm session for a user

• No ugly error message during installation if config file does not exist yet
• Add deprecation warnings for token and session configuration

• Basic functionality