Skip to content

Conversation

@tomaj
Copy link
Owner

@tomaj tomaj commented Aug 28, 2025

Summary

This is a major version bump to 4.0.0 with breaking changes. Updates minimum PHP version to 8.1 and PHPUnit to 10.5.53.

Breaking Changes

⚠️ BREAKING CHANGES:

  • Minimum PHP version: 7.4 → 8.1
  • Dropped support: PHP 7.4 and 8.0 no longer supported
  • PHPUnit update: 9.6.25 → 10.5.53 (requires PHP 8.1+)

Changes

Added

  • Support for latest PHPUnit 10.5.53 features and improvements

Changed

  • 🔥 BREAKING: Minimum PHP version increased from 7.4 to 8.1
  • 📦 PHPUnit updated from 9.6.25 to 10.5.53
  • 🔧 phpunit.xml.dist updated to PHPUnit 10.5 schema format
  • ⚙️ CI matrix now tests only PHP 8.1, 8.2, and 8.3
  • 📋 Coverage configuration restructured for PHPUnit 10

Removed

  • 🔥 BREAKING: Dropped support for PHP 7.4 and 8.0

Migration Guide

Projects using this library will need to:

  1. Update PHP version to 8.1 or higher
  2. Update composer.json:
    "require": {
      "php": ">=8.1",
      "tomaj/bank-mails-parser": "^4.0"
    }
  3. Projects that cannot upgrade PHP should stay on version 3.x

Technical Details

  • PHPUnit 10 requires PHP 8.1+ (this was the blocking issue)
  • All existing tests pass without any code changes
  • Coverage reporting continues to work as expected
  • No changes to public API - only infrastructure upgrades

Testing

✅ All 39 tests pass successfully on PHP 8.1+:

PHPUnit 10.5.53 by Sebastian Bergmann and contributors.
.......................................   39 / 39 (100%)
Time: 00:00.155, Memory: 82.03 MB
OK (39 tests, 333 assertions)

Version Strategy

  • v3.x: Last version supporting PHP 7.4+ (maintenance only)
  • v4.x: New major version supporting PHP 8.1+ with modern tooling

tomaj added 3 commits August 28, 2025 19:40
- Update PHPUnit constraint to ^10 in composer.json
- Update phpunit.xml.dist schema to 10.5 format
- Restructure coverage configuration for PHPUnit 10
- All tests pass successfully with new version
- Add entry to CHANGELOG.md
This is a major version bump to 4.0.0 with breaking changes:

- Minimum PHP version increased from 7.4 to 8.1
- Updated PHPUnit from 9.6.25 to 10.5.53
- Updated phpunit.xml.dist configuration for PHPUnit 10
- Removed PHP 7.4 and 8.0 from CI test matrix
- CI now tests only PHP 8.1, 8.2, and 8.3
- All tests pass successfully with new versions
- Updated CHANGELOG.md for version 4.0.0

BREAKING CHANGES:
- Dropped support for PHP 7.4 and 8.0
- Projects using PHP < 8.1 must stay on version 3.x
- Updated PHPUnit from 9.6.25 to 11.5.35 (latest version)
- Updated minimum PHP requirement from 7.4 to 8.2
- Updated CI matrix to test only PHP 8.2, 8.3, and 8.4
- Updated phpunit.xml.dist schema to 11.5
- Added PHP version requirement badge to README
- Updated CHANGELOG.md for version 4.0.0 with breaking changes
@tomaj tomaj merged commit 97cb07e into master Aug 28, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants