PHPackages                             creativeorange/laravel-injectable - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. creativeorange/laravel-injectable

ActiveLibrary[Utility & Helpers](/categories/utility)

creativeorange/laravel-injectable
=================================

Injecting variables into models after they were retrieved from the database.

v3.0.0(1y ago)218211MITPHPPHP >=8.0.2

Since Oct 29Pushed 1y ago1 watchersCompare

[ Source](https://github.com/creativeorange/laravel-injectable)[ Packagist](https://packagist.org/packages/creativeorange/laravel-injectable)[ Docs](https://github.com/creativeorange/laravel-injectable)[ RSS](/packages/creativeorange-laravel-injectable/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (3)Versions (7)Used By (1)

Laravel Injectable
==================

[](#laravel-injectable)

[![Total Downloads](https://camo.githubusercontent.com/0cc6818d713ad3f659fa6d52cabb90f5502f3b5af0526939182a009bfe1f586e/68747470733a2f2f706f7365722e707567782e6f72672f63726561746976656f72616e67652f6c61726176656c2d696e6a65637461626c652f642f746f74616c2e737667)](https://packagist.org/packages/creativeorange/laravel-injectable)[![Latest Stable Version](https://camo.githubusercontent.com/f55ba4ee63065ed223ff3674612b82202dd1c0e3dba260c506edeb59348f0b1e/68747470733a2f2f706f7365722e707567782e6f72672f63726561746976656f72616e67652f6c61726176656c2d696e6a65637461626c652f762f737461626c652e737667)](https://packagist.org/packages/creativeorange/laravel-injectable)[![License](https://camo.githubusercontent.com/2bcfd199116108c22021d5e58a91a78cfd18138493d7926f32870b84fce63ef8/68747470733a2f2f706f7365722e707567782e6f72672f63726561746976656f72616e67652f6c61726176656c2d696e6a65637461626c652f6c6963656e73652e737667)](https://packagist.org/packages/creativeorange/laravel-injectable)

A package for injecting variables into models after they were retrieved from the database.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require creativeorange/laravel-injectable
```

For Laravel 8 and lower you should require version 1.

If you are using [Spaties Laravel Translatable](https://github.com/spatie/laravel-translatable) this package needs an extra plugin, read instructions in: [Laravel Injectable translatable extension](https://github.com/creativeorange/laravel-translatable-and-injectable)

Usage
-----

[](#usage)

In this example we make use of a `Question` model. This model has two attributes: `name` and `description`.

How are variables stored
------------------------

[](#how-are-variables-stored)

Under the hood, we use Laravel's translation system and helper method `__()`. Therefor we need variables to be stored as `:variable_name`. In this readme, we use the variable `:company_name`.

Setup the model
---------------

[](#setup-the-model)

First, make sure the `$casts` attribute on the model is filled:

```
protected $casts = [
    'name'          => \Creativeorange\LaravelInjectable\Casts\InjectableCast::class,
    'description'   => \Creativeorange\LaravelInjectable\Casts\InjectableCast::class
];
```

After this, we can replace variables in the from the database retrieved attributes.

Per attribute
-------------

[](#per-attribute)

```
$question = \App\Models\Question::first();

$question->name->inject('company_name', 'Acme Inc.');

// or to use multiple:
$question->name->inject(['company_name', 'Acme Inc.', 'another_var' => 'Another val']);

echo $question->name; // will output the name with the variables replaced
echo $question->description; // will output the original text, without any replacements; for example: This is the description for company :company_name
```

As shown here, only the `name` attributes will contain replacements, the `description` still shows the original text from the database.

Per model
---------

[](#per-model)

For this, the model needs to use the `App\InjectableTrait` trait. After this, a `inject` method is available on the model.

```
$question = \App\Models\Question::first();

$question->inject('company_name', 'Acme Inc.');
// or to use multiple:
$question->inject(['company_name', 'Acme Inc.', 'another_var' => 'Another val']);

echo $question->name; // will output the name with the variables replaced
echo $question->description; // will output the description with the variables replaced
```

In this example, all variables will be replaced in the fields that were casted by the `App\Casts\InjectableCast`.

Per request-cycle
-----------------

[](#per-request-cycle)

Another use case is that you want to replace all the variables on request-level.

```
// Use the alias
\LaravelInjectable::set('company_name', 'Acme Inc.');

// Or directly use the facade
\CreativeOrange\LaravelInjectable\Facades\LaravelInjectable::set('company_name', 'Acme Inc.');

// Or via the app method
app(\Creativeorange\LaravelInjectable\LaravelInjectable::class)->set('company_name', 'Acme Inc.');

// Or set multiple vars at once
\LaravelInjectable::set(['company_name', 'Acme Inc.', 'another_var' => 'Another val']);
\LaravelInjectable::set('company_name', 'Acme Inc.')->set('another_var', 'Another val');

$question = \App\Models\Question::first();
echo $question->name; // will output the name with the variables replaced
echo $question->description; // will output the description with the variables replaced
```

### Bonus: The Blade directive: Per request-cycle

[](#bonus-the-blade-directive-per-request-cycle)

Same as above, but then in blade

```
@inj('company_name', 'Acme Inc.')
//or to use multiple
@inj(['company_name', 'Acme Inc.', 'another_var' => 'Another val'])

@php($question = \App\Models\Question::first());
{{ $question->name }} {{-- will output the name with the variables replaced --}}
{{ $question->description}} {{-- will output the description with the variables replaced --}}
```

### Testing

[](#testing)

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Credits
-------

[](#credits)

- [Jaco Tijssen](https://github.com/creativeorange)
- [Jonathan Hafkamp](https://github.com/creativeorange)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~463 days

Total

4

Last Release

682d ago

Major Versions

1.0.1 → v2.0.02022-05-04

v2.0.0 → v3.0.02024-08-19

PHP version history (2 changes)v1.0.0PHP >=7.2.5

v2.0.0PHP >=8.0.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/09c2af1aacfc3f405a56c5532985cb3b18f44520f24d9e2345d3a66acfc610ea?d=identicon)[creativeorange](/maintainers/creativeorange)

![](https://avatars.githubusercontent.com/u/16034333?v=4)[Jonathan Hafkamp](/maintainers/dejury)[@dejury](https://github.com/dejury)

![](https://avatars.githubusercontent.com/u/8997440?v=4)[Jaco Tijssen](/maintainers/jacotijssen)[@jacotijssen](https://github.com/jacotijssen)

---

Top Contributors

[![Edsardio](https://avatars.githubusercontent.com/u/10669035?v=4)](https://github.com/Edsardio "Edsardio (2 commits)")

---

Tags

creativeorangelaravel-injectable

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/creativeorange-laravel-injectable/health.svg)

```
[![Health](https://phpackages.com/badges/creativeorange-laravel-injectable/health.svg)](https://phpackages.com/packages/creativeorange-laravel-injectable)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[illuminate/pagination

The Illuminate Pagination package.

12234.1M1.0k](/packages/illuminate-pagination)[illuminate/pipeline

The Illuminate Pipeline package.

9349.2M279](/packages/illuminate-pipeline)[illuminate/broadcasting

The Illuminate Broadcasting package.

7127.2M208](/packages/illuminate-broadcasting)[illuminate/redis

The Illuminate Redis package.

8314.6M371](/packages/illuminate-redis)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)