Skip to content

HP-2693: Upgrade PHPUnit to v12 #107

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

HP-2693: Upgrade PHPUnit to v12 #107

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8390bc6
HP-2693: Upgrade PHPUnit to v12
VadymHrechukha Sep 9, 2025
eef640d
HP-2693: update vimeo/psalm to the latest 6.13.1 version in order to …
VadymHrechukha Sep 9, 2025
f852866
HP-2693: added requirements of `php: ^8.3` because `phpunit/phpunit: …
VadymHrechukha Sep 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions composer.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,17 +50,18 @@
"cache/array-adapter": "^1.2"
},
"require-dev": {
"php": "^8.3",
"ext-intl": "*",
"behat/behat": "^3.4.3",
"phpunit/phpunit": "^10.0.0",
"phpunit/phpunit": "^12.0",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Verification agent

🧩 Analysis chain

Sanity-check PHPUnit 12 ecosystem constraints before merging.

PHPUnit 12 may raise minimum PHP or sebastian/* requirements compared to v10. Validate your runtime/tooling matrix and deprecations in the test suite (e.g., removed APIs, annotations).

🌐 Web query:

What PHP version and sebastian/* package versions does phpunit/phpunit 12.x require? List notable breaking changes from PHPUnit 11->12.

💡 Result:

Short answer

  • PHP: PHPUnit 12 requires PHP >= 8.3. [1]
  • sebastian/* (representative required versions in PHPUnit 12.x composer):
    • sebastian/cli-parser: ^4.0.0
    • sebastian/comparator: ^7.0.1
    • sebastian/diff: ^7.0.0
    • sebastian/environment: ^8.0.1
    • sebastian/exporter: ^7.0.0
    • sebastian/global-state: ^8.0.0
    • sebastian/object-enumerator: ^7.0.0
    • sebastian/type: ^6.0.2
    • sebastian/version: ^6.0.0
      (See composer.json for full dependency list / exact minor versions.) [2]

Notable breaking changes when upgrading from PHPUnit 11 → 12

  • PHP requirement raised to PHP ≥ 8.3 (you cannot install PHPUnit 12 on older PHP). [1]
  • Annotation (doc‑comment) metadata support removed — migrate all @test, @before, @after, @dataProvider, etc. to PHP attributes. (Annotations were deprecated in PHPUnit 11 and removed in 12.) [1][3]
  • Test‑double API cleanup and removals:
    • Methods for creating mocks/stubs for abstract classes and traits removed (previously deprecated). [1][4]
    • Configuring expectations on objects created with createStub() no longer works (was deprecated earlier). [1][4]
    • TestCase helper methods that returned stub configuration objects (returnValue, returnValueMap, onConsecutiveCalls, returnArgument, returnSelf, returnCallback, etc.) were removed — use the shorthand willReturn/willReturnMap/willReturnCallback/etc. instead. [4]
  • Functionality that was only soft‑deprecated in PHPUnit 11 is hard‑deprecated/removed in 12 — run your suite under PHPUnit 11.5 and fix deprecation warnings before upgrading. [1]

Sources

  1. PHPUnit 12 release announcement / requirements and major changes. [phpunit.de announcement]. [1]
  2. PHPUnit 12.x composer.json dependency snapshot (shows PHP platform and sebastian/* constraints). [composer.json diff / package listing]. [2]
  3. Notes / guidance on removing doc‑comment metadata and migrating to attributes. [community article / PHPUnit docs]. [3]
  4. Issue / PR tracking removal of TestCase return* methods and other test‑double removals. [GitHub issue]. [4]

If you want, I can paste the exact composer.json dependency block for PHPUnit 12.x (or link to the tag) so you can copy the exact constraints.

composer.json (line 55): require PHP ≥ 8.3 and bump sebastian/ deps for PHPUnit 12*
Update the PHP requirement to >=8.3 and set sebastian/cli-parser to ^4.0.0, comparator to ^7.0.1, diff to ^7.0.0, environment to ^8.0.1, exporter to ^7.0.0, global-state to ^8.0.0, object-enumerator to ^7.0.0, type to ^6.0.2, and version to ^6.0.0. Migrate all annotations (@test, @before, @after, @dataProvider, etc.) to PHP 8 attributes and replace removed TestCase stub helpers (returnValue*, returnValueMap, onConsecutiveCalls, returnArgument, returnSelf, returnCallback, etc.) with the willReturn* shorthands. Run your suite under PHPUnit 11.5 to clear deprecation warnings before upgrading.

🤖 Prompt for AI Agents 
In composer.json around line 55, update the PHP platform requirement to ">=8.3"
and add explicit version constraints for the sebastian packages required by
PHPUnit 12 (set sebastian/cli-parser to ^4.0.0, sebastian/comparator to ^7.0.1,
sebastian/diff to ^7.0.0, sebastian/environment to ^8.0.1, sebastian/exporter to
^7.0.0, sebastian/global-state to ^8.0.0, sebastian/object-enumerator to ^7.0.0,
sebastian/type to ^6.0.2, and sebastian/version to ^6.0.0); then update test
code by converting PHPUnit annotations (@test, @before, @after, @dataProvider,
etc.) to PHP 8 attributes and replace removed TestCase stub helpers
(returnValue*, returnValueMap, onConsecutiveCalls, returnArgument, returnSelf,
returnCallback, etc.) with the willReturn* shorthands; finally run the test
suite under PHPUnit 11.5, fix any deprecation warnings, then proceed to upgrade
to PHPUnit 12.

"league/event": "^2.1",
"hoa/ruler": "^2.17",
"hiqdev/hidev": "dev-master",
"hiqdev/hidev-php": "dev-master",
"hiqdev/hidev-behat": "dev-master",
"hiqdev/hidev-hiqdev": "dev-master",
"hiqdev/php-data-mapper": "dev-master",
"vimeo/psalm": "^5.0",
"vimeo/psalm": "^6.13.1",
"opis/closure": "3.x-dev as 3.6.x-dev",
"cache/array-adapter": "*",
"matthiasnoback/behat-expect-exception": "^v0.3.0",
Expand Down
Loading