Laravel News Laravel News
News

Heartbeat Collection Method in Laravel 12.26; Wayfinder Now in React and Vue Starter Kits

Published
Heartbeat Collection Method in Laravel 12.26; Wayfinder Now in React and Vue Starter Kits image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team released version 12.26.0, adding a withHeartbeat() method to Lazy collections, a toPrettyJson() method to collections, models, and more. Additionally, the Laravel Vue and React starter kits include Wayfinder, which bridges type-safe routes between Laravel and your frontend.

React and Vue Starter Kits Now Include Wayfinder

Joe Tannenbaum updated the Laravel React and Vue Starter Kits to include Laravel Wayfinder. Wayfinder provides a type-safe bridge between your Laravel routes and frontend:

import { store, update } from "@/actions/App/Http/Controllers/PostController";
 
const Page = () => (
    <form {...update.form.put(1)}>
        {/* <form action="/posts/1?_method=PUT" method="post"> */}
        {/* ... */}
    </form>
);

Add withHeartbeat() Method to LazyCollection

Joseph Silber contributed a new withHeartbeat() method to LazyCollection, which allows you to run a callback at regular intervals while the collection is being lazily enumerated. Joseph shared the primary use-case for this method in Pull Request #56477:

In long-running tasks such as batch processing reports, you may need to hold a lock to prevent concurrent execution. However, if the code unexpectedly fails to release the lock, you don't want it to persist indefinitely. A common strategy is to acquire a short-lived lock, and then periodically extend it while the task is still running.

Here's an example where we acquire a lock for 5 minutes, then reacquire it every 4 minutes (assuming a report never takes a full minute to generate):

$lock = Cache::lock('generate-reports', CarbonInterval::minutes(5));
 
$lock->acquire();
 
Reports::where('status', 'pending')
    ->lazy()
    ->withHeartbeat(CarbonInterval::minutes(4), $lock->reacquire(...))
    ->each($this->generateReport(...));
 
$lock->release();

The collections documentation has been updated, including a section about the withHeartbeat() method.

Pretty JSON Method

Wendell Adriel contributed a toPrettyJson() method, implemented in most places where the toJson() method exists. For example, collections, models, JSON resources, paginators, Fluent instances, and message bags. Here's an example from Pull Request #56697 using collections:

// Before
$collection = collect([1,2,3]);
$collection->toJson(JSON_PRETTY_PRINT);
 
// After
$collection = collect([1,2,3]);
$collection->toPrettyJson();

Release notes

You can see the complete list of new features and updates below and the diff between 12.25.0 and 12.26.0 on GitHub. The following release notes are directly from the changelog:

v12.26.0

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

X X Github Github
Filed in
News Laravel Releases

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article