Inertia Laravel Laravel Package

What's Changed

• [3.x] Add rescue option to Deferred Props by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/864

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v3.0.6...v3.1.0

What's Changed

• [3.x] Ensure callables are objects by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/862

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v3.0.5...v3.0.6

What's Changed

• [3.x] Handle redirect status codes with global middleware by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/860

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v3.0.4...v3.0.5

What's Changed

• Revert "[3.x] Fix middleware priority" by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/859

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v3.0.3...v3.0.4

What's Changed

• [3.x] Add Inertia::disableSsr() method by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/856
• [3.x] Add pages transform callback by [@nhedger](https://github.com/nhedger) in https://github.com/inertiajs/inertia-laravel/pull/841
• [3.x] Fix middleware priority by [@jlswanson28694](https://github.com/jlswanson28694) in https://github.com/inertiajs/inertia-laravel/pull/854
• [3.x] Add SSR runtime config option by [@shaffe-fr](https://github.com/shaffe-fr) in https://github.com/inertiajs/inertia-laravel/pull/857

New Contributors

• [@nhedger](https://github.com/nhedger) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/841
• [@jlswanson28694](https://github.com/jlswanson28694) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/854

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v3.0.2...v3.0.3

What's Changed

• Update facade docblocks in https://github.com/inertiajs/inertia-laravel/commit/25fe835d0fadf988d2cd8974d4a7b64048f84eda

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v3.0.1...v3.0.2

What's Changed

• [3.x] Migrate Blade components to inline syntax by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/850

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v3.0.0...v3.0.1

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v3.0.0-beta5...v3.0.0

What's Changed

• [2.x] Supports Laravel 13 by [@crynobone](https://github.com/crynobone) in https://github.com/inertiajs/inertia-laravel/pull/822
• Add Boost Guidelines & Skills by [@pushpak1300](https://github.com/pushpak1300) in https://github.com/inertiajs/inertia-laravel/pull/828

New Contributors

• [@pushpak1300](https://github.com/pushpak1300) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/828

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.20...v2.0.21

What's Changed

• Removed duplicate import of RedirectResponse by [@kitro](https://github.com/kitro) in https://github.com/inertiajs/inertia-laravel/pull/813
• [2.x] Add assertInertiaFlash and assertInertiaFlashMissing test response macros by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/827
• Fix inertia prop modifiers being ignored in provider classes by [@TimKunze96](https://github.com/TimKunze96) in https://github.com/inertiajs/inertia-laravel/pull/821

New Contributors

• [@kitro](https://github.com/kitro) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/813
• [@TimKunze96](https://github.com/TimKunze96) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/821

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.19...v2.0.20

What's Changed

• [2.x] Allow ScrollProp to be deferred by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/806

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.18...v2.0.19

What's Changed

• Add test helpers for Flash Data by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/804

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.17...v2.0.18

What's Changed

• Fix flash data loss on non-Inertia redirects by [@TomKita](https://github.com/TomKita) in https://github.com/inertiajs/inertia-laravel/pull/802

New Contributors

• [@TomKita](https://github.com/TomKita) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/802

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.16...v2.0.17

What's Changed

• Add test for deferred metadata on subsequent request by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/799
• Support for Flash Data by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/797

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.15...v2.0.16

What's Changed

• Check if prop value is callable and not a string by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/798

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.14...v2.0.15

What's Changed

• Exclude loaded once props from deferred metadata by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/796

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.13...v2.0.14

What's Changed

• Include onceProps metadata for fresh props by [@skryukov](https://github.com/skryukov) in https://github.com/inertiajs/inertia-laravel/pull/794

New Contributors

• [@skryukov](https://github.com/skryukov) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/794

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.12...v2.0.13

What's Changed

• Ability to use <script> element for initial page data by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/788
• Support for once() props by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/793

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.11...v2.0.12

What's Changed

• Add PHP 8.5 to test matrix by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/787
• Support for multiple validation errors per field by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/784
• Handle array inputs in reloadOnly and reloadExcept by [@hosmelq](https://github.com/hosmelq) in https://github.com/inertiajs/inertia-laravel/pull/792
• Handle Connection Exceptions During Health Checks by [@Magnesium38](https://github.com/Magnesium38) in https://github.com/inertiajs/inertia-laravel/pull/786

New Contributors

• [@Magnesium38](https://github.com/Magnesium38) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/786

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.10...v2.0.11

What's Changed

• Include scrollProps metadata when prop is requested to reset by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/781

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.9...v2.0.10

What's Changed

• Add docblock to Inertia Facade for scroll by [@joetannenbaum](https://github.com/joetannenbaum) in https://github.com/inertiajs/inertia-laravel/pull/780

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.8...v2.0.9

What's Changed

• More fine-grained control for Inertia::merge() and a new Inertia::scroll() by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/774

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.7...v2.0.8

What's Changed

• Added loadDeferredProps() method to AssertableInertia class by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/779

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.6...v2.0.7

What's Changed

• Add encrypt history middleware that follows laravel naming conventions by [@taylorotwell](https://github.com/taylorotwell) in https://github.com/inertiajs/inertia-laravel/pull/773

New Contributors

• [@taylorotwell](https://github.com/taylorotwell) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/773

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.5...v2.0.6

What's Changed

• [2.x] Improve inertia helper docblock by [@mtlukaszczyk](https://github.com/mtlukaszczyk) in https://github.com/inertiajs/inertia-laravel/pull/766
• [2.x] Introduce ProvidesInertiaProp interface by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/746
• [2.x] Introduce ProvidesInertiaProps interface by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/769
• Introduce PHPStan + improve DocBlocks by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/768

New Contributors

• [@mtlukaszczyk](https://github.com/mtlukaszczyk) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/766

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.4...v2.0.5

What's Changed

• [2.x] Ability to perform a SSR request without a bundle by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/751
• [2.x] Added inertia:check-ssr Artisan command and isHealthy() method on HttpGateway by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/752
• [2.x] Refactor HttpGateway by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/754
• [2.x] Support for checking if the component exists when rendering by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/749
• [2.x] Refactored ssr.dispatch_without_bundle to ssr.ensure_bundle_exists by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/755
• [2.x] Restore testing.page_paths and testing.page_extensions configs by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/756
• GitHub issue template by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/757
• update return type in Middleware share method by [@hosmelq](https://github.com/hosmelq) in https://github.com/inertiajs/inertia-laravel/pull/758
• Fix project name in SECURITY.md by [@duncanmcclean](https://github.com/duncanmcclean) in https://github.com/inertiajs/inertia-laravel/pull/759
• [2.x] Remove old version checks by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/763

New Contributors

• [@hosmelq](https://github.com/hosmelq) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/758
• [@duncanmcclean](https://github.com/duncanmcclean) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/759

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.3...v2.0.4

What's Changed

• Run tests on Ubuntu 24.04 by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/735
• Improve URL handling with support for trailing slashes by [@ljbw](https://github.com/ljbw) in https://github.com/inertiajs/inertia-laravel/pull/731
• [2.x] Remove old LegacyTestResponse by [@nshiro](https://github.com/nshiro) in https://github.com/inertiajs/inertia-laravel/pull/736
• [2.x] Introduce inertiaProps Method in TestResponseMacros for Improved Inertia.js Testing by [@ashokatheheroo](https://github.com/ashokatheheroo) in https://github.com/inertiajs/inertia-laravel/pull/700
• [2.x] Remove check for TestResponse from Laravel <= 6.0 by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/743
• [2.x] Check Vite manifest before Mix manifest by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/737
• [2.x] Remove IDE helpers by [@ycs77](https://github.com/ycs77) in https://github.com/inertiajs/inertia-laravel/pull/675
• [2.x] Allow deepMerge on custom properties by [@mpociot](https://github.com/mpociot) in https://github.com/inertiajs/inertia-laravel/pull/732
• [2.x] Test helper for partial requests by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/738
• [2.x] Support for a custom URL resolver by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/739
• [2.x] Keep only partial data in mergeProps by [@vinnygambiny](https://github.com/vinnygambiny) in https://github.com/inertiajs/inertia-laravel/pull/745
• [2.x] Refactor mergeStrategies argument to matchOn() method by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/747

New Contributors

• [@ljbw](https://github.com/ljbw) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/731
• [@nshiro](https://github.com/nshiro) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/736
• [@ashokatheheroo](https://github.com/ashokatheheroo) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/700
• [@mpociot](https://github.com/mpociot) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/732
• [@vinnygambiny](https://github.com/vinnygambiny) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/745

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.2...v2.0.3

What's Changed

• [2.x] Supports Laravel 12 by [@crynobone](https://github.com/crynobone) in https://github.com/inertiajs/inertia-laravel/pull/709
• Add Inertia::deepMerge Method for Handling Complex Data Merges in Responses by [@HichemTab-tech](https://github.com/HichemTab-tech) in https://github.com/inertiajs/inertia-laravel/pull/679
• Improve PHPDoc annotations for ResponseFactory class by [@mohammadrasoulasghari](https://github.com/mohammadrasoulasghari) in https://github.com/inertiajs/inertia-laravel/pull/723
• fix props that extends Responsable after closures / lazy props by [@d8vjork](https://github.com/d8vjork) in https://github.com/inertiajs/inertia-laravel/pull/722
• [2.x] Allow environment config for ssr.enabled, ssr.url, and history.encrypt by [@bram-pkg](https://github.com/bram-pkg) in https://github.com/inertiajs/inertia-laravel/pull/714
• Replace array_merge with spread operator in middleware.stub by [@osbre](https://github.com/osbre) in https://github.com/inertiajs/inertia-laravel/pull/710
• [2.x] Resolve Closure before checking if a prop implements the Arrayable contract by [@rodrigopedra](https://github.com/rodrigopedra) in https://github.com/inertiajs/inertia-laravel/pull/706
• Handle SSR URLs with trailing slashes by [@simon-tma](https://github.com/simon-tma) in https://github.com/inertiajs/inertia-laravel/pull/705
• [2.x] Call toArray() on Arrayable props resolved from the Container by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/696
• [2.x] Replace md5 with xxhash by [@RobertBoes](https://github.com/RobertBoes) in https://github.com/inertiajs/inertia-laravel/pull/653

New Contributors

• [@HichemTab-tech](https://github.com/HichemTab-tech) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/679
• [@mohammadrasoulasghari](https://github.com/mohammadrasoulasghari) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/723
• [@d8vjork](https://github.com/d8vjork) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/722
• [@bram-pkg](https://github.com/bram-pkg) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/714
• [@osbre](https://github.com/osbre) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/710
• [@simon-tma](https://github.com/simon-tma) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/705
• [@pascalbaljet](https://github.com/pascalbaljet) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/696

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.1...v2.0.2

• Allow Laravel 12.x.

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.0...v2.0.1

• Add support for Inertia.js v2.0.0
• Add Inertia::defer() to support deferred props
• Add Inertia::merge() to support merging props on client
• Add Inertia::always() for props that should always be included (#627)
• Add Inertia::clearHistory() and Inertia::encryptHistory() methods, encryption config, and encryption middleware
• Deprecated Inertia::lazy() in favor of Inertia::optional()
• Drop support for Laravel 8 and 9 (#629)

• Make commands lazy (#601)
• Add persistent properties (#621)
• Exclude except props from partial reloads (#622)

• Support dot notation in partial requests (#620)
• Add $request->inertia() IDE helper (#625)

• Add Laravel 11 support (#560, #564)
• Fix URL generation (#592)
• Remove deprecated Assert class and Laravel 6 & 7 support. (#594)

• Add option for using the bun runtime in SSR (#552)

What's Changed

• [2.x] Prevent Boost conflict by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/838
• [2.x] Fix SSR shutdown URL construction by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/843

Full Changelog: https://github.com/inertiajs/inertia-laravel/compare/v2.0.21...v2.0.22

• Conditionally use pcntl extension in inertia:start-ssr command (#492)

• Reintroduce inertia.ssr.enabled config option (#488)
• Fix bug where SSR is dispatched twice when errors exist (#489)

• Report SSR errors (#486)
• Auto enable SSR based on existence of SSR bundle (#487)

• Add inertia:start-ssr and inertia:stop-ssr artisan commands (#483)

• Add Laravel v10 support (#480)

• Add PHP 8.2 support (#463)

• Check Vite manifest path (build/manifest.json) when determining the current asset version (#399)

• Switch to using the Vary: X-Inertia header (#404)
• Fix bug with incompatible $request->header() method (#404)

• Add inertia_location helper function (#491)
• Add Route::inertia() IDE helper (#413)
• Automatically update Facade docblocks (#538)
• Restore request and session on redirects (#539)
• Add PHP 8.3 support (#540)

• Set Vary: Accept header for all responses (#398)
• Only register Blade directives when actually needed (#395)

Added

• Inertia now redirects back by default when no response is returned from a controller (#350)
• The Middleware has an overridable onEmptyResponse hook to customize the default 'redirect back' behavior (#350)

Changed

• Internal: Replaced the Middleware's checkVersion method with an onVersionChange hook (#350)

Fixed

• Fixed namespace issue with Route::inertia() method (#368)
• Added session check when sharing validation errors (#380)
• Fixed docblock on facade render method (#387)

Added

• .tsx extension is now included to the testing paths by default (#354)

Fixed

• Dot-notated props weren't being removed after unpacking (507b0a)

Fixed

• Incorrect Arrayable type-hint (#353)
• Pagination with API Resources and other nested props weren't resolving properly (#342, #298)

Added

• Laravel 9 Support (#347)

Fixed

• Respect X-Forwarded-For header (#333)

Fixed

• When the SSR Server crashes, a null response will be returned, which wasn't being handled properly (7d7d89)

Added

• PHP 8.1 Support (#327)
• Allow Inertia::location to be called with a RedirectResponse (#302)
• Support Guzzle Promises (#316)
• Server-side rendering support ([@inertiaHead](https://github.com/inertiaHead) directive) (#339)
• Allow custom [@inertia](https://github.com/inertia) root element ID (e.g. [@inertia](https://github.com/inertia)('foo') -> <div id="foo" data-page="...) (#339)

Changed

• We now keep a changelog here on GitHub :tada: For earlier releases, please see the releases page of inertiajs.com.
• Add PHP native type declarations (#301, #337)

Deprecated

• Deprecate Assert library in favor of Laravel's AssertableJson (#338)

Removed

• Laravel 5.4 Support (#327)

Fixed

• Transform Responsable props to arrays instead of objects (#265)
• Inertia::location(): Fall back to regular redirects when a direct (non-Inertia) visit was made (#312)
• Use correct types for Resources (#214)