Skip to main content

PHP SDK Changelog

All notable changes to the Trading Card API PHP SDK will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.1.0] - 2025-09-15​

🎉 Initial stable release of the Trading Card API PHP SDK

Added​

Core SDK Features​

  • Complete SDK implementation with all core Trading Card API endpoints
  • Laravel integration with service provider, facades, and helper functions
  • Full API resource support for Cards, Players, Sets, Teams, Genres, Brands, Manufacturers, Years, and more
  • Response validation and schema handling for reliable data processing
  • Professional documentation with comprehensive examples and guides

Enhanced Error Handling​

  • Base TradingCardApiException with common properties and methods
  • Specific exception classes for different error scenarios:
    • AuthenticationException for 401 authentication failures
    • AuthorizationException for 403 permission errors
    • ValidationException for 422 validation errors with field-level details
    • RateLimitException for 429 rate limiting with retry timing information
    • ResourceNotFoundException with specific subclasses:
      • CardNotFoundException
      • PlayerNotFoundException
      • SetNotFoundException
    • NetworkException for connection and network-related errors
    • ServerException for 5xx server errors
  • ErrorResponseParser service for intelligent error response parsing
  • Comprehensive test coverage for all exception scenarios

Platform Compatibility​

  • PHP Support: 8.1, 8.2, 8.3, and 8.4
  • Laravel Support: 10.x, 11.x, and 12.x (actively maintained versions)
  • Quality Assurance: Full PHPStan compliance and Laravel Pint code styling

Development & CI/CD​

  • Comprehensive GitHub Actions workflows for automated testing and deployment
  • Multi-version testing across PHP and Laravel combinations
  • Automated release process with version management
  • Professional build system matching API repository standards

Changed​

  • Updated build system to match API repository's sophisticated release process
  • Enhanced version management with PHP/Composer integration for seamless updates
  • Improved release automation and documentation generation
  • Modernized dependencies - removed Laravel 9.x support (end of life February 2024)
  • Updated GitHub Actions to latest compatible versions for improved performance

Fixed​

  • Version script compatibility issues with repositories having no git tags
  • Changelog formatting and markdown linting compliance for better readability
  • Code quality improvements addressing styling issues for production readiness
  • Test matrix compatibility issues with Laravel 11+ and prefer-lowest dependency strategy
  • PHPStan static analysis errors in ErrorResponseParser for type safety

Getting Updates​

To update to the latest version of the PHP SDK:

# Update via Composer
composer update cardtechie/tradingcardapi-sdk-php

# Or install a specific version
composer require cardtechie/tradingcardapi-sdk-php:^0.1.0

Migration Guides​

Upgrading to v0.1.0​

This is the initial stable release. If you were using any pre-release versions:

  1. Update your composer.json:

    {
      "require": {
        "cardtechie/tradingcardapi-sdk-php": "^0.1.0"
      }
    }

  2. Review error handling: The stable release includes enhanced exception classes. Update your catch blocks to use the new specific exceptions.

  3. Check Laravel compatibility: Ensure you're using Laravel 10.x or higher.

Breaking Changes​

v0.1.0​

  • Laravel 9.x support removed - Minimum Laravel version is now 10.x
  • PHP 8.0 support removed - Minimum PHP version is now 8.1

Support​

For questions about specific versions or upgrade assistance:

This changelog is automatically synchronized with the PHP SDK repository. For the most up-to-date information, please refer to the repository.