NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1928 most downloaded on Packagist
An advanced Laravel integration for Bref, including Octane support.
Latest stable
3.1.6
Last release 17 days ago
05 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 55 of 56 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
59 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Require riverline/multipart-parser 2.3 by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/223
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.1.5...3.1.6
Set CACHE_STORE in the serverless.yml stub by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/221
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.1.4...3.1.5
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Deprecate the bref.request_context option by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/216
With Octane (and with Bref\LaravelBridge\Http\HttpHandler), the files uploaded with a request were never deleted: they stayed in the Lambda instance's /tmp until it was full, and then everything that writes to /tmp failed, Laravel's storage included. They are now deleted when the next request starts. Thanks @felipehertzer for finding it!
Bref 3.0.13 is now required: before it, Bref's cleanup missed every upload on PHP 8.4 and up.
When a failed job could not be stored (for example with the default database-uuids failed job driver in an application without a database), the error replaced the job's own exception, which was never logged or reported. Both errors are now reported.
bref.request_contextThe option adds the X-Request-ID header to the shared log context, and API Gateway does not send that header (only the Octane and function runtimes of this package set it), so it did nothing with PHP-FPM. On Lambda, Bref's log formatter now starts every log line with the request ID (documentation). The option will be removed in the next major version.
bref.request_context option by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/216Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.1.3...3.1.4
bref.request_context config option: it adds the X-Request-ID header to the shared log context, and API Gateway does not send that header (only the Octane and function runtimes of this package set it), so the option did nothing with PHP-FPM. On Lambda, Bref's log formatter now starts every log line with the request ID: documentation. The option will be removed in the next major version.Bref\LaravelBridge\Http\HttpHandler never deleted the files uploaded with a request: they stayed in the reused Lambda instance's /tmp until it was full. Like Bref's PSR-15 handler, they now delete the previous request's uploads when a request starts. Bref 3.0.13 is now required: before it, Bref's cleanup missed every upload on PHP 8.4 and up.database-uuids failed job driver in an application without a database), the error replaced the job's own exception, which was never logged or reported. Both errors are now reported.Allow bref/monolog-bridge 2.0 by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/213
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.1.2...3.1.3
bref/monolog-bridge 2.0: on Lambda, log lines start with the request ID of the invocation, so that all the logs of a request can be found with it: documentation. To keep the previous log format, require bref/monolog-bridge: ^1.0 in your application.Comment out the Lift plugin in the serverless.yml stub by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/212
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.1.1...3.1.2
serverless-lift plugin is commented out in the serverless.yml stub, like the constructs: the first deployment of a new application no longer fails when Lift is not installed. Install Lift and uncomment the plugin to use constructs.Expose the stack name in config('bref.stack_name') by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/211
config('bref.stack_name') by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/211Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.1.0...3.1.1
bref.stack_name config value: the name of the CloudFormation stack (BREF_STACK_NAME environment variable, set by Bref when deploying with serverless.yml). It lets applications forward queue names to Lift queues: documentation.Simple large file uploads via presigned S3 URLs by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/210
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.8...3.1.0
POST /signed-upload-url by default, protected by authentication and the uploadFiles gate. Set bref.uploads.route to null to disable the route.Add font files to serverless.yml for Laravel 13 by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/209
serverless.yml for Laravel 13 by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/209Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.7...3.0.8
Add fonts-manifest.json to serverless.yml for Laravel 13 by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/208
fonts-manifest.json to serverless.yml for Laravel 13 by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/208Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.6...3.0.7
Improve docs/stub for zero-downtime asset deploys and serving public files by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/207
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.5...3.0.6
Map prod stage to Laravel production env by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/204
prod stage to Laravel production env by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/204Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.4...3.0.5
Fix job retry: use the SQS queue URL instead of name by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/201
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.3...3.0.4
Improve testing setup & add commands to observe failed jobs by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/200
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.2...3.0.3
Improve serverless.yml default config for the storage bucket by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/199
serverless.yml default config for the storage bucket by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/199Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.1...3.0.2
Improve serverless.yml default config for the storage bucket by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/198
serverless.yml default config for the storage bucket by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/198Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.0...3.0.1
The CloudWatch formatter change is the only breaking change.
Bref 3.0 is released 🎉
Read the full blog post here: bref.sh/news/03-bref-3.0
The full upgrade guide is here: https://bref.sh/docs/upgrading/v3
<img width="1600" height="759" alt="Bref v3" src="https://github.com/user-attachments/assets/f922f530-ba84-4edf-af8c-fe8099e8e8c0" />
serverless.yml to improve onboarding by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/195The CloudWatch formatter change is the only breaking change.
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.7.1...3.0.0
serverless.yml configSee https://github.com/brefphp/bref/releases/tag/3.0.0-beta1 for more context.
See https://github.com/brefphp/bref/releases/tag/3.0.0-beta1 for more context.
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.0-alpha2...3.0.0-beta1
Fix compatibility with Bref v3 Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.0-alpha1...3.0.0-alpha2
Fix compatibility with Bref v3
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/3.0.0-alpha1...3.0.0-alpha2
Read https://github.com/brefphp/laravel-bridge/pull/190 for details
Bref v3 support.
Read https://github.com/brefphp/laravel-bridge/pull/190 for details
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.7.0...3.0.0-alpha1
Print a warning if Laravel Vapor is detected by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/194
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.7.0...2.7.1
Allow pre-compiling views before deployment by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/188
bref tinker command by @datpmwork in https://github.com/brefphp/laravel-bridge/pull/187https://github.com/user-attachments/assets/29c007ad-2eb0-4ee6-914c-5d4f7b4817e9
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.6.0...2.7.0
Require bref/monolog-bridge by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/184
bref/monolog-bridge by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/184The Bref\Monolog\CloudWatchFormatter is now usable, which will automatically format logs for CloudWatch.
Read https://bref.sh/docs/environment/logs#writing-logs to learn more.
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.5.6...2.6.0
Exclude assets from deployment by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/181
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.5.5...2.5.6
Update BrefServiceProvider.php by @JGamboa in https://github.com/brefphp/laravel-bridge/pull/179
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.5.4...2.5.5
Reset the scoped singleton for each job processing in the queue by @hogeraccio in https://github.com/brefphp/laravel-bridge/pull/178
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.5.3...2.5.4
Overrides emergency logger if it is defaulted by @j-fulbright in https://github.com/brefphp/laravel-bridge/pull/175
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.5.2...2.5.3
Laravel 12.x Compatibility by @laravel-shift in https://github.com/brefphp/laravel-bridge/pull/172
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.5.1...2.5.2
Exclude more paths by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/171
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.5.0...2.5.1
New option to disable job logging by @MightySepp666 in https://github.com/brefphp/laravel-bridge/pull/170
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.4.5...2.5.0
Handle 'common' web file MIME types by @eddmann in https://github.com/brefphp/laravel-bridge/pull/168
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.4.4...2.4.5
Automatically install health checks by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/164
I'm releasing this as a patch version because, even though it adds a new feature, 99% of users will not see any change.
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.4.3...2.4.4
Exclude sqlite databases from the deployment by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/163
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.4.2...2.4.3
Fix support for Laravel 11 by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/161
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.4.1...2.4.2
Prevent crash if key attribute is missing by @DocLM in https://github.com/brefphp/laravel-bridge/pull/159
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.4.0...2.4.1
Improve patching of AWS credentials by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/157
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.3.1...2.4.0
fixes logging of scheduled tasks by @aknosis in https://github.com/brefphp/laravel-bridge/pull/156
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.3.0...2.3.1
Implement same logic on bref-init by @alustau in https://github.com/brefphp/laravel-bridge/pull/135
error level for queue failure by @tillkruss in https://github.com/brefphp/laravel-bridge/pull/148Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.2.1...2.3.0
Setting whether to output the initialization log by @KentarouTakeda in https://github.com/brefphp/laravel-bridge/pull/143
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.2.0...2.2.1
Support Octane 2 & PHP 8.3 by @deleugpn in https://github.com/brefphp/laravel-bridge/pull/141
config:cache by @sunaoka in https://github.com/brefphp/laravel-bridge/pull/128Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.1.3...2.2.0
Take an optional $path parameter when bootstrapping Octane by @deleugpn in https://github.com/brefphp/laravel-bridge/pull/124
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.1.2...2.1.3
@marcusrettig made their first contribution in https://github.com/brefphp/laravel-bridge/pull/122
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.1.1...2.1.2
Fix issue #112 - Request to AWS SES API failed. Reason: The Security Token included in the request is invalid by @olkitu in https://github.com/brefphp
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.1.0...2.1.1
Allow running Tinker commands on Lambda by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/104
serverless.yml to the correct directory by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/99serverless.yml config by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/100Full Changelog: https://github.com/brefphp/laravel-bridge/compare/2.0.0...2.1.0
This major release is a significant change in the Laravel integration with Bref.
This major release is a significant change in the Laravel integration with Bref.
Note:
You can read more about this is the Bref 2.0 release blog post
Indeed, the Laravel bridge v1.x was lagging behind and was limited in some features. The community (CacheWerk, Till Krüss, and George Boot) maintained a better alternative at cachewerk/bref-laravel-bridge.
For Bref 2.0, the contributors joined the Bref organization, and the CacheWerk bridge was merged into this repository to create v2.0 of this bridge (#94)!
/tmp.app.mix_url from app.asset_urlX-Request-ID header to the log contextchannels.stderr.formatter to Monolog\Formatter\JsonFormatter::class in config/logging.php.APP_SSM_PREFIX and APP_SSM_PARAMETERS has been removed. The native Bref 2.0 feature to load SSM parameters into environment variables can be used instead (#36)bref/runtime.php file, remove the APP_RUNTIME environment variable (in serverless.yml) and set your Octane function handler to: handler: Bref\LaravelBridge\Http\OctaneHandler.bref/runtime.php file, remove the APP_RUNTIME environment variable (in serverless.yml) and set your Octane function handler to: handler: Bref\LaravelBridge\Queue\QueueHandler.Full Changelog: https://github.com/brefphp/laravel-bridge/compare/1.2.3...2.0.0
Laravel 10.x Compatibility by @laravel-shift in https://github.com/brefphp/laravel-bridge/pull/89
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/1.2.2...1.2.3
Removes lambda hashing version from template by @rafaellaurindo in https://github.com/brefphp/laravel-bridge/pull/85
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/1.2.1...1.2.2
Allow Bref v2 beta by @mnapoli in https://github.com/brefphp/laravel-bridge/pull/83
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/1.2.0...1.2.1
Allow Laravel v9 and Symfony v6 by @hmazter in https://github.com/brefphp/laravel-bridge/pull/64
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/1.1.3...1.2.0
Quote excluded directories by @t-richard in https://github.com/brefphp/laravel-bridge/pull/58
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/1.1.2...1.1.3
Update the serverless.yml template: remove the deprecated package.exclude syntax + switch to PHP 8 by @t-richard in https://github.com/brefphp/laravel…
serverless.yml template: remove the deprecated package.exclude syntax + switch to PHP 8 by @t-richard in https://github.com/brefphp/laravel-bridge/pull/56Full Changelog: https://github.com/brefphp/laravel-bridge/compare/1.1.1...1.1.2
lambdaHashingVersion set to 20201221 by @dasundev in https://github.com/brefphp/laravel-bridge/pull/55
Full Changelog: https://github.com/brefphp/laravel-bridge/compare/1.1.0...1.1.1
New php artisan vendor:publish --tag=serverless-worker command to create worker.php.
New php artisan vendor:publish --tag=serverless-worker command to create worker.php.
The documentation also now uses Lift to create the SQS queue. That is much simpler than using CloudFormation.
Make sure view.compiled is correctly defined #39
Make sure view.compiled is correctly defined #39
There are no BC breaks in this package, however read the upgrade guide of Bref 1.0 to see if you need to update anything.
Upgrade to Bref 1.0 and PHP 8.
There are no BC breaks in this package, however read the upgrade guide of Bref 1.0 to see if you need to update anything.
#19 SQS worker exceptions are now correctly reported to error handlers defined in Laravel
#19 SQS worker exceptions are now correctly reported to error handlers defined in Laravel
Nothing published for this version
Move the default cache directory to /tmp to avoid read-only errors
This release autoconfigures Laravel to run on AWS Lambda.
This release autoconfigures Laravel to run on AWS Lambda.
This is done via a Laravel service provider that is automatically registered on installation. That makes deploying a new Laravel application on Lambda much easier:
composer require bref/laravel-bridge
php artisan vendor:publish --tag=serverless-config
serverless deploy
Authorization: Basic header into PHP_AUTH_* variables (#10)Content-Type (08ab941)[Unreleased]: https://github.com/cachewerk/bref-laravel-bridge/compare/v0.3.0...HEAD [v0.3.0]: https://github.com/cachewerk/bref-laravel-bridge/compar
One column per quarter.