Laravel Release Notes

• [13.x] Add connection and queue to WorkerStopping by @jackbayliss in https://github.com/laravel/framework/pull/61387
• [13.x] Add insertOrIgnoreReturning() to the Eloquent builder passthru by @xurshudyan in https://github.com/laravel/framework/pull/61393
• [13.x] Add dropVectorIndex() to the schema blueprint by @xurshudyan in https://github.com/laravel/framework/pull/61391
• [13.x] Fix limit() being ignored on update() for SQL Server by @xurshudyan in https://github.com/laravel/framework/pull/61394
• [13.x] Prevent orphaned Redis tagged cache entries by @drewmt in https://github.com/laravel/framework/pull/61385

• [12.x] Backport #60908: Avoid quadratic wildcard rule expansion by @matteo-palazzo in https://github.com/laravel/framework/pull/61232
• Fix resource loading by @taylorotwell in https://github.com/laravel/framework/pull/61323
• [13.x] Output the worker stop reason in queue:work by @jackbayliss in https://github.com/laravel/framework/pull/61339
• Fix incorrect $startTime type in Worker::stopIfNecessary docblock by @il-m-tomita in https://github.com/laravel/framework/pull/61347
• [13.x] Ability to opt out of vendor/default commands in DevCommands by @jackbayliss in https://github.com/laravel/framework/pull/61344
• [13.x] Confine Storage::path() to the configured disk root by @KIKOmanasijev in https://github.com/laravel/framework/pull/61343
• [13.x] Support Microsoft SQL Server DSN connection strings by @HenkPoley in https://github.com/laravel/framework/pull/61341
• [13.x] Restore the facade application after route:cache boots a fresh application by @reiarseni in https://github.com/laravel/framework/pull/61346
• [13.x] Gracefully handle missing param value or strings with request clamps by @kylemilloy in https://github.com/laravel/framework/pull/61355
• [13.x] Restore default database connection when seeding fails by @sayful1411 in https://github.com/laravel/framework/pull/61354
• [13.x] Cloud enhancements by @timacdonald in https://github.com/laravel/framework/pull/61360 …

Pull request by @taylorotwell

Laravel now includes a read-through filesystem driver for gradually migrating files between disks. It checks the primary disk first; when a file exists only on the fallback disk, Laravel returns it and copies it to the primary disk for future requests. Writes and directory listings continue to target the primary disk, while streamed reads are supported without loading the entire file into memory.

'assets' => [
    'driver' => 'read-through',
    'primary' => 'r2',
    'fallback' => 'legacy-s3',
],

Pull request by @eas4ai

Laravel now provides the AsVector Eloquent cast for working with vector columns as arrays of floats. The cast handles MariaDB's binary vector representation as well as PostgreSQL-compatible text values, accepts arrays and Arrayable objects when storing vectors, and correctly converts query bindings for MariaDB vector distance functions.

use Illuminate\Database\Eloquent\Casts\AsVector;

class Document extends Model
{
    protected $casts = [
        'embedding' => AsVector::class,
    ];
}

Pull request by @Rhaima96

Laravel's vector query methods now support MariaDB's native vector capabilities. Methods such as whereVectorSimilarTo, whereVectorDistanceLessThan, orderByVectorDistance, and selectVectorDistance compile to MariaDB's vector distance functions, bringing the same expressive query API previously available for PostgreSQL to supported MariaDB releases.

$documents = Document::query()
    ->whereVectorSimilarTo('embedding', $queryEmbedding)
    ->orderByVectorDistance('embedding', $queryEmbedding)
    ->get();

Pull request by @stevebauman

The #[DebounceFor] attribute can now be applied to queued event listeners. When several events arrive for the same resource during the debounce period, Laravel processes only the most recently dispatched listener, making it a natural fit for work such as updating a product search index after a burst of changes. A maxWait value can ensure a continuous stream of events does not defer the listener indefinitely.

use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Queue\Attributes\DebounceFor;

#[DebounceFor(30, maxWait: 120)]
class UpdateProductSearchIndex implements ShouldQueue
{
    public function debounceId(ProductUpdated $event): string
    {
        return (string) $event->product->getKey();
    }
}

Pull request by @taylorotwell

Laravel Scout now includes a Turbopuffer engine with batched indexing, automatic namespace creation, weighted BM25 full-text search, filtering, and vector distance metadata. It uses Laravel's HTTP client directly, so no additional Turbopuffer PHP SDK is required.

This release also introduces semantic and hybrid search support for Scout's database engine. Applications can use generated or precomputed embeddings through the familiar Scout builder API, with support for vector search, text search, filters, pagination, and configurable search weights.

$documents = Document::search('ocean climate')
    ->semantic()
    ->where('published', true)
    ->get();

• [13.x] Prevent duplicate scoped instance registrations by @jordanhavard in https://github.com/laravel/framework/pull/61251
• [13.x] Add refreshForUpdate() method to Eloquent models by @stevebauman in https://github.com/laravel/framework/pull/61247
• [13.x] Fix PHPUnit and Mockery deprecations in tests by @lucasmichot in https://github.com/laravel/framework/pull/61244
• [13.x] Throw on unsuccessful responses when creating images from URLs by @Button99 in https://github.com/laravel/framework/pull/61254
• Apply fixes from StyleCI by @taylorotwell in https://github.com/laravel/framework/pull/61256
• [13.x] Skip scheduled workflows on forks by @MrPunyapal in https://github.com/laravel/framework/pull/61239
• [13.x] Consolidate tearDown boilerplate into AfterEachTestSubscriber by @lucasmichot in https://github.com/laravel/framework/pull/61245
• [13.x] Pin rector version by @lucasmichot in https://github.com/laravel/framework/pull/61257
• [13.x] Re-introduce orWhereKey() and orWhereKeyNot() without breaking Builder subclasses by @kevariable in https://github.com/laravel/framework/pull/61242
• [13.x] Don't force release a unique lock the job never acquired by @sulimanbenhalim in https://github.com/laravel/framework/pull/61234
• [13.x] Convert foreach-loop tests to data providers by @lucasmichot in https://github.com/laravel/framework/pull/61258
• [13.x] Simplify testImageBmp by @lucasmichot in https://github.com/laravel/framework/pull/61259 …

New features

• Added support for the PHP 8.6 beta
• Added CPX as a bundled command-line tool
• Service binaries can now be reinstalled from Settings → Services (currently available for PostgreSQL)
• Sites with internationalized domain names are now served correctly
• Added Node.js 24 LTS to the available Node versions

Fixes and Improvements

• Fixed Herd writing duplicate extension entries in php.ini, causing "Module herd is already loaded" warnings
• Newer Expose binaries are no longer overwritten when Herd updates its bundled copy
• Updated the built-in Expose binary
• Updated the built-in Laravel Installer
• Updated the built-in Composer binary
• Updated the built-in cacert.pem bundle