nocs/laravel-retriever

Retrieve cached data made simple.

Maintainers

Package info

github.com/nineoclocksomewhere/laravel-retriever

pkg:composer/nocs/laravel-retriever

Transparency log

Statistics

Installs: 2 375

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 0

v1.1.12 2026-06-22 14:00 UTC

README

Latest Version on Packagist Total Downloads

Laravel Retriever resolves small PHP classes and methods by a string key, then memoizes their return values through Laravel's cache manager. It is useful for reusable, cacheable data providers such as lookup lists, external-data snapshots, and application-level reference data.

Install

composer require nocs/laravel-retriever

Laravel package discovery registers Nocs\\Retriever\\Providers\\RetrieverServiceProvider automatically. The provider binds the retriever manager and scans app/Retrievers and app/Cache during application boot.

Quick example

Create app/Cache/Colors.php:

<?php

namespace App\Cache;

class Colors
{
    public function red(): string
    {
        return 'red';
    }
}

Retrieve it from application code:

$value = retriever()->get('colors.red');
// or: $value = retriever('colors.red');

The class name and method segment are normalized with Laravel's Str::snake/Str::camel conventions. A class with only a get() method can be addressed as retriever('colors').

Documentation

Development

composer validate --strict
composer test

See Testing and verification for the CI matrix and source-level checks.

Support and license

Report security issues privately to the maintainer rather than through the public issue tracker. This package is released under the MIT license.