Laravel Release Notes

[12.x] Backport #60908: Avoid quadratic wildcard rule expansion by @matteo-palazzo in #61232

Fix resource loading by @taylorotwell in #61323

[13.x] Output the worker stop reason in queue:work by @jackbayliss in #61339

Fix incorrect $startTime type in Worker::stopIfNecessary docblock by @il-m-tomita in #61347

[13.x] Ability to opt out of vendor/default commands in DevCommands by @jackbayliss in #61344

[13.x] Confine Storage::path() to the configured disk root by @KIKOmanasijev in #61343

[13.x] Support Microsoft SQL Server DSN connection strings by @HenkPoley in #61341

[13.x] Restore the facade application after route:cache boots a fresh application by @reiarseni in #61346

[13.x] Gracefully handle missing param value or strings with request clamps by @kylemilloy in #61355

[13.x] Restore default database connection when seeding fails by @sayful1411 in #61354

[13.x] Cloud enhancements by @timacdonald in #61360

[13.x] Allow retrieving command by name without resolving all commands by @timacdonald in #61361

[13.x] Expose methods by @timacdonald in #61362

[13.x] Add basic test for query explain by @imanghafoori1 in #61363

[13.x] Add totalXSize methods to Cloud Queue by @jackbayliss in #61352

[13.x] Add chunkBy to collections by @JosephSilber in #61357

[13.x] spl_object_id over hash by @jackbayliss in #61372

[13.x] Add createPayloadUsing directly to the queue manager by @jackbayliss in #61367

[13.x] Set visibility on files that only exist on a read-through disk's fallback by @sulimanbenhalim in #61375

[12.x] Disable html by default on Laravel exception page tooltip by @crynobone in #61381

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();