Efficient Memoization with Laravel's Once Helper

Prerequisites

To follow this tutorial, you should have a baseline understanding of PHP and the Laravel framework. Familiarity with anonymous functions (closures) and static methods will help you grasp the implementation details. You will need Laravel 11 or higher to use this as a built-in feature.

Key Libraries & Tools

• Laravel Framework: The primary PHP framework providing the helper.
• Spatie once: The original package that inspired this native implementation.
• Tinkerwell: An excellent code runner for testing Laravel snippets in real-time.

Code Walkthrough

Suppose we have a Podcast model with a static method that fetches featured shows via an action class. Without optimization, every call triggers a new query.

// Before: Every call hits the database
public static function featured()
{
    return (new GetFeaturedPodcastsAction)->execute();
}

To optimize this, wrap the logic in the once helper. The helper accepts a callable and stores the result based on the calling context.

// After: Optimized with the once helper
public static function featured()
{
    return once(fn () => (new GetFeaturedPodcastsAction)->execute());
}

When the application executes this code three times in one request, Laravel runs the inner logic on the first attempt, caches the return value, and serves that cached value for calls two and three. This eliminates redundant database overhead instantly.

Syntax Notes

The once helper uses the object instance or class and the method name to create a unique cache key. It relies on a closure (fn () => ...) to encapsulate the logic you want to memoize. This pattern is much cleaner than manually checking if a property is null before assigning a value.

Tips & Gotchas

Remember that once only persists for the duration of the current HTTP request. If you need to store data across multiple requests or for hours at a time, you must use Laravel's standard Cache facade. Additionally, be mindful of state; if the underlying data changes mid-request, once will still return the original result until the request ends.