Phpunit Snapshot Assertions Laravel Package

What's Changed

• Add vendor/bin/update-snapshots wrapper binary that sets UPDATE_SNAPSHOTS=true and runs PHPUnit. This replaces the previously documented phpunit -d --update-snapshots syntax, which abused PHPUnit's -d flag and produces a Failed to set "--update-snapshots=1" test runner warning since PHPUnit 12.5.12.
• Drop the phpunit -d --without-creating-snapshots form from the README. Use the CREATE_SNAPSHOTS=false environment variable instead. The argv check is kept in shouldCreateSnapshots() for backwards compatibility.
• The wrapper restores the prior UPDATE_SNAPSHOTS env var state on shutdown, so it does not leak a state mutation to any in-process code that runs after PHPUnit.
• Reworded the "Snapshot does not exist" failure message and the "snapshots can be updated by..." prompt to point at the new approach.
• shouldUpdateSnapshots() and shouldCreateSnapshots() now check the env var first, then fall back to the legacy CLI argument.
• Fix tests on PHPUnit 12.5+, where mocks throwing AssertionFailedError are tracked as a test failure even when user code catches the exception. The expectFail helper now uses a plain RuntimeException carrying the expected message.

Closes #242.

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.3.2...5.4.0

What's Changed

• Fix BC break in getSnapshotId() from named snapshots feature — restored original no-parameter signature
• Add README documentation for named snapshots

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.3.1...5.3.2

What's Changed

• Allow PHPUnit 13

What's Changed

• Add support for PHPUnit 9.6 by @alex-dev in https://github.com/spatie/phpunit-snapshot-assertions/pull/235
• Add PHPUnit versioning to CI matrix to test against multiple PHPUnit versions
• Add PhpUnitCompatibility trait for cross-version compatibility
• Fix CI workflow to properly handle PHPUnit version constraints

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.2.3...5.3.0

What's Changed

• Update issue template by @AlexVanderbist in https://github.com/spatie/phpunit-snapshot-assertions/pull/222
• feat: allow symfony 8 by @Chris53897 in https://github.com/spatie/phpunit-snapshot-assertions/pull/228
• Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in https://github.com/spatie/phpunit-snapshot-assertions/pull/223

New Contributors

• @Chris53897 made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/228

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.2.2...5.2.3

What's Changed

• Bump aglipanci/laravel-pint-action from 2.5 to 2.6 by @dependabot[bot] in https://github.com/spatie/phpunit-snapshot-assertions/pull/217
• Update parameter type hints in ObjectDriver constructor docblock by @tassilogroeper in https://github.com/spatie/phpunit-snapshot-assertions/pull/220
• Bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/spatie/phpunit-snapshot-assertions/pull/219

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.2.1...5.2.2

What's Changed

• Bump dependabot/fetch-metadata from 2.3.0 to 2.4.0 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/213
• Bump stefanzweifel/git-auto-commit-action from 5 to 6 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/215
• Allow assertMatchesJsonSnapshot to accept any JSON-serializable value by @LuckyWindsck in https://github.com/spatie/phpunit-snapshot-assertions/pull/216

New Contributors

• @LuckyWindsck made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/216

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.2.0...5.2.1

What's Changed

• Allow setting yamlInline for ObjectDriver by @tassilogroeper in https://github.com/spatie/phpunit-snapshot-assertions/pull/212

New Contributors

• @tassilogroeper made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/212

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.1.8...5.2.0

What's Changed

• Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/207
• Bump aglipanci/laravel-pint-action from 2.4 to 2.5 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/208
• Allow phpunit 12 by @mfruehauf in https://github.com/spatie/phpunit-snapshot-assertions/pull/209

New Contributors

• @mfruehauf made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/209

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.1.7...5.1.8

What's Changed

• Bump dependabot/fetch-metadata from 2.1.0 to 2.2.0 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/203
• Bump oven-sh/setup-bun from 1 to 2 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/202
• gha: run tests against PHP 8.4 too by @erikn69 in https://github.com/spatie/phpunit-snapshot-assertions/pull/204
• Improve readability of generated JSON snapshots by @ostrolucky in https://github.com/spatie/phpunit-snapshot-assertions/pull/205

New Contributors

• @erikn69 made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/204
• @ostrolucky made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/205

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.1.6...5.1.7

What's Changed

• Update symfony version in deps by @Niolak in https://github.com/spatie/phpunit-snapshot-assertions/pull/196
• Fix/v4 permissions snapshot files by @Niolak in https://github.com/spatie/phpunit-snapshot-assertions/pull/201

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.16...4.2.17

What's Changed

• Minor updates and improvements by @patinthehat in https://github.com/spatie/phpunit-snapshot-assertions/pull/192
• Bump aglipanci/laravel-pint-action from 2.3.1 to 2.4 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/194
• Bump dependabot/fetch-metadata from 2.0.0 to 2.1.0 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/200
• chmod snapshot folders and files by @Niolak in https://github.com/spatie/phpunit-snapshot-assertions/pull/199

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.1.5...5.1.6

What's Changed

• gha: run tests against PHP 8.3 too by @mfn in https://github.com/spatie/phpunit-snapshot-assertions/pull/188
• Use PHPUnit attributes by @simonhammes in https://github.com/spatie/phpunit-snapshot-assertions/pull/187

New Contributors

• @simonhammes made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/187

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.1.4...5.1.5

What's Changed

• Bump aglipanci/laravel-pint-action from 2.3.0 to 2.3.1 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/183
• Allow phpunit 11 by @mfn in https://github.com/spatie/phpunit-snapshot-assertions/pull/185

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.1.3...5.1.4

What's Changed

• Bump actions/setup-node from 3 to 4 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/181
• Symfony 7.0 by @janatjak in https://github.com/spatie/phpunit-snapshot-assertions/pull/182

New Contributors

• @janatjak made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/182

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.1.2...5.1.3

What's Changed

• Bump actions/setup-node from 2 to 3 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/176
• fix: correct typo in readme by @TSchuermans in https://github.com/spatie/phpunit-snapshot-assertions/pull/178
• Fix #179 - assert difference between empty array and object. by @Sam152 in https://github.com/spatie/phpunit-snapshot-assertions/pull/180
• Bump stefanzweifel/git-auto-commit-action from 4 to 5 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/177

New Contributors

• @TSchuermans made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/178
• @Sam152 made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/180

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.1.1...5.1.2

• fix image driver

What's Changed

• Add image assertions by @freekmurze in https://github.com/spatie/phpunit-snapshot-assertions/pull/175

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.0.2...5.1.0

What's Changed

• Generate snapshot file names with dataset by @pierres in https://github.com/spatie/phpunit-snapshot-assertions/pull/163
• Bump aglipanci/laravel-pint-action from 0.1.0 to 2.1.0 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/164
• Update windows users info in readme.md by @raveren in https://github.com/spatie/phpunit-snapshot-assertions/pull/150

New Contributors

• @pierres made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/163
• @raveren made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/150

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/5.0.0...5.0.1

What's Changed

• Add Dependabot Automation by @patinthehat in https://github.com/spatie/phpunit-snapshot-assertions/pull/152
• Add PHP 8.2 Support by @patinthehat in https://github.com/spatie/phpunit-snapshot-assertions/pull/151
• Bump actions/checkout from 2 to 3 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/153
• Bump dependabot/fetch-metadata from 1.3.5 to 1.3.6 by @dependabot in https://github.com/spatie/phpunit-snapshot-assertions/pull/159
• Fix badge with run-tests status in README.md by @gomzyakov in https://github.com/spatie/phpunit-snapshot-assertions/pull/160
• add support for PHPUnit v10 by @freekmurze in https://github.com/spatie/phpunit-snapshot-assertions/pull/154

New Contributors

• @patinthehat made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/152
• @dependabot made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/153
• @gomzyakov made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/160

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.16...5.0.0

What's Changed

• serialize empty HTML by @Khartir in https://github.com/spatie/phpunit-snapshot-assertions/pull/148

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.15...4.2.16

What's Changed

• Apply PCRE_UTF8 for cleaning filename by @su-kun1899 in https://github.com/spatie/phpunit-snapshot-assertions/pull/147

New Contributors

• @su-kun1899 made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/147

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.14...4.2.15

What's Changed

• Add tests for Text Driver and Windows EOL fixes by @mallardduck in https://github.com/spatie/phpunit-snapshot-assertions/pull/146

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.13...4.2.14

What's Changed

• Add test to cover HTML without doctype by @mallardduck in https://github.com/spatie/phpunit-snapshot-assertions/pull/144
• Add type safe json matching by @cschindl in https://github.com/spatie/phpunit-snapshot-assertions/pull/145

New Contributors

• @cschindl made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/145

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.12...4.2.13

What's Changed

• Use LIBXML_HTML_NODEFDTD to maintain output consistency by @JayBizzle in https://github.com/spatie/phpunit-snapshot-assertions/pull/141

New Contributors

• @JayBizzle made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/141

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.11...4.2.12

What's Changed

• revert match process in JsonDriver by @Stevemoretz in https://github.com/spatie/phpunit-snapshot-assertions/pull/138

New Contributors

• @Stevemoretz made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/138

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.10...4.2.11

What's Changed

• Normalize windows line endings on HTML tests by @mallardduck in https://github.com/spatie/phpunit-snapshot-assertions/pull/136

New Contributors

• @mallardduck made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/136

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.9...4.2.10

What's Changed

• Do not convert stdClass to array && remove outdated piece of code by @alshenetsky in https://github.com/spatie/phpunit-snapshot-assertions/pull/134

New Contributors

• @alshenetsky made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/134

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.8...4.2.9

What's Changed

• Update php-cs-fixer config by @gndk in https://github.com/spatie/phpunit-snapshot-assertions/pull/132
• Allow Symfony 6.0 by @gndk in https://github.com/spatie/phpunit-snapshot-assertions/pull/133

New Contributors

• @gndk made their first contribution in https://github.com/spatie/phpunit-snapshot-assertions/pull/132

Full Changelog: https://github.com/spatie/phpunit-snapshot-assertions/compare/4.2.7...4.2.8

• clean filenames on MatchesFileSnapshot for Windows (#130)