Laravel Release Notes

[12.x]

Ensure password hash matches stored cookie before authenticating the user by @crynobone in #61386

Fix TypeError in userFromRecaller() when the recaller matches no user by @lazerg in #61397

[13.x]

Add totalSize method to Queue by @jackbayliss in #61373

Merge branch '12.x' into 13.x by @crynobone in #61399

Restore the container instance after route:cache boots a fresh application by @lazerg in #61405

Include connection and queue on WorkerStopping when worker is killed by @jackbayliss in #61408

Fix lazy() and lazyById() ignoring limit() and offset() by @xurshudyan in #61402

JobInterrupted event by @jackbayliss in #61412

Make the Redis queue driver cluster-safe (bulk() node-less MULTI; allQueueNames() uses KEYS) by @Orrison in #61198

feat: add chaperone support for BelongsToMany pivot models by @calebdw in #61152

Dedupe common test fixtures by @jasonmccreary in #61422

feat: improve higher order proxy generic types by @calebdw in #61418

Apply fixes from StyleCI by @taylorotwell in #61427

Add once assertions to the mail and notification fakes by @talaridisTh in #61415

Let Monolog handle deprecation exceptions by @sysdev34-wq in #61414

Default memoryExceededExitCode for Cloud by @jackbayliss in #61430

Fix context not being propagated to concurrent processes by @newtonjob in #61419

Remove the unused Request import from the JSON:API resource stub by @Bosun18 in #61434

Memory leak fix in Http Client by @skr4dan in #61438

Fix SelfBuilding build stack cleanup after exceptions by @emrebalasar in #61454

defer all logic to the dedicated rule by @browner12 in #61445

Wrap the closure return type in withFreshQueryLog() by @SanderMuller in #61444

Fix assertJsonMissingPath() ignoring wildcards by @xurshudyan in #61441

Resolve the UsePolicy attribute from parent classes by @xurshudyan in #61439

Resolve the UseEloquentBuilder attribute from parent classes by @xurshudyan in #61440

Fix parameter docblocks that contradict the native signature by @dfinchenko in #61457

Bump softprops/action-gh-release from 3.0.2 to 3.0.3 in the github-actions group by @dependabot[bot] in #61468

Fix RateLimited job middleware hitting limits that did not block the job by @xurshudyan in #61449

Add devServerUrl() to Vite by @ramonmalcolm10 in #61465

Retry phpredis commands when a connection reset surfaces as a warning by @Orrison in #61462

Fix callbacks deferred from within a deferred callback by @newtonjob in #61431

Propagate command_retries to phpredis cluster connections by @Orrison in #61460

Qualify soft delete column with the query's table alias by @arunarw in #61456

Keep Eloquent on the direct connection during migrations by @danielebarbaro in #61435

Apply fixes from StyleCI by @taylorotwell in #61470

Fix Class Illuminate\Session\ArraySessionHandler implementing SessionHandlerInterface is missing the create_sid() method which will be required in PHP 9.0 by @crynobone in #61469

Fix route url generation under certain circumstances by @taylorotwell in #61475

Fix message ID and header persistence on ResendTransport by @saurabhsharma2u in #61476

Fix wherePivot() closure scope being ignored in pivot table operations by @iz-ahmad in #61488

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