PHPackages                             thatsus/laravel-better-bind - 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. thatsus/laravel-better-bind

ActiveLibrary

thatsus/laravel-better-bind
===========================

A better bind feature for automated tests in Laravel

v1.0.1(7y ago)09MITPHPPHP >=7.0.0

Since Aug 15Pushed 7y ago2 watchersCompare

[ Source](https://github.com/thatsus/laravel-better-bind)[ Packagist](https://packagist.org/packages/thatsus/laravel-better-bind)[ RSS](/packages/thatsus-laravel-better-bind/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (5)Dependencies (4)Versions (10)Used By (0)

laravel-better-bind
===================

[](#laravel-better-bind)

A better bind feature for automated tests in Laravel/Lumen 5+.

Why Better Bind is better
=========================

[](#why-better-bind-is-better)

1. It's less verbose than Laravel's built-in option.
2. It protects you against missing constructor parameters.
3. You can choose to check the constructor parameters for correctness.

Automated testing in Laravel using mocks means injecting objects using the Application's `bind` method.

This can have some drawbacks.

- `App::bind` is verbose in Laravel.
- `App::bind` doesn't test that an object is instantiated with the right parameters.

Better Bind provides a syntactically friendly mechanism to verify that constructor parameters match your target class.

Missing required parameters cause an assertion failure.

Extra parameters cause an assertion failure.

Wrong-type parameters cause an assertion failure.

It can be a one-liner.

Better Bind also provides a way to capture the constructor parameters so you can run your own assertions on them.

Installation
============

[](#installation)

```
composer require thatsus/laravel-better-bind

```

```
class TestCase
{
    use \ThatsUs\BetterBind;

    ...
}
```

Example Test
============

[](#example-test)

In this example we expect the `Dog::bark` method to create a `Sound` object with itself as the value for the constructor's `$animal` parameter.

First, we use the `betterInstance` method from Better Bind to provide the mock to the code. Then we capture the `$params` argument and check at the end that it has the parameter values we expect.

```
class DogTest extends TestCase
{
    public function testBark()
    {
        $mock = Mockery::mock(Sound::class);
        $mock->shouldReceive('emit')
            ->once();
        $this->betterInstance(Sound::class, $mock, $params);

        $dog = new Dog();
        $dog->bark();

        $this->assertEquals(['animal' => $dog], $params);
    }
}
```

```
class Sound
{
    public function __construct(Animal $animal)
    {
        // ...
    }
}
```

Passing Code
------------

[](#passing-code)

Gallant wrote this code correctly with the right parameters for the constructor.

```
class Dog
{
    public function bark()
    {
        App::makeWith(Sound::class, ['animal' => $this])->emit();
    }
}
```

Failing Code 1
--------------

[](#failing-code-1)

Goofus forgot to include the name of the parameter for the constructor.

```
class Dog
{
    public function bark()
    {
        App::makeWith(Sound::class, [$this])->emit();
    }
}
```

```
1) DogTest::testBark
Required parameter `animal` not provided to class constructor for `Sound`

```

Failing Code 2
--------------

[](#failing-code-2)

Now Goofus included an extra parameter for the constructor by accident.

```
class Dog
{
    public function bark()
    {
        App::makeWith(Sound::class, ['animal' => $this, 'volume' => 'loud'])->emit();
    }
}
```

```
1) DogTest::testBark
Extra parameters provided to class constructor for `Sound`: `volume`

```

Failing Code 3
--------------

[](#failing-code-3)

Goofus accidentally passed in a string. That's the wrong type for the `$animal` parameter.

```
class Dog
{
    public function bark()
    {
        App::makeWith(Sound::class, ['animal' => 'this'])->emit();
    }
}
```

```
1) DogTest::testBark
Required parameter `animal` for `Sound` is a `string`, but a `Animal` is expected.

```

Methods
=======

[](#methods)

### betterInstance($signature, $object, \[&$params = \[\]\])

[](#betterinstancesignature-object-params--)

- $signature - string, the class name or other string requested in a `makeWith` call.
- $object - mixed, the value to return from the `makeWith` call.
- $params - optional, when `makeWith` is called, this variable will be updated with the parameters sent to `makeWith` so that your test code may make assertions against them.

If `$signature` is a string that does not refer to an existing class, no assertions will run against the parameters.

### betterBind($signature, $closure, \[&$params = \[\]\])

[](#betterbindsignature-closure-params--)

- $signature - string, the class name or other string requested in a `makeWith` call.
- $closure - a closure that will be called when `makeWith` is called. The return value will be returned from `makeWith`. The parameters will be `$app`, the Application object, and `$params`, the array of parameters sent to `makeWith`.
- $params - optional, when `makeWith` is called, this variable will be updated with the parameters sent to `makeWith` so that your test code may make assertions against them.

If `$signature` is a string that does not refer to an existing class, no assertions will run against the parameters.

### betterBind(...)->ignoreParameters($param1, $param2, ...)

[](#betterbind-ignoreparametersparam1-param2-)

Allow Laravel to supply the parameters named. Do not check that the given parameter names are given by the call to `makeWith`.

- $paramN - string, the name of a parameter

I'm not convinced. Can't I do this without Better Bind?
=======================================================

[](#im-not-convinced-cant-i-do-this-without-better-bind)

You can do some of the same stuff without this library.

Compare the following versions of the test.

```
class DogTest extends TestCase
{
    public function testBark()
    {
        $mock = Mockery::mock(Sound::class);
        $mock->shouldReceive('emit')
            ->once();
        $this->betterInstance(Sound::class, $mock, $params);

        $dog = new Dog();
        $dog->bark();

        $this->assertEquals(['animal' => $dog], $params);
    }
}
```

```
class DogTest extends TestCase
{
    public function testBark()
    {
        $mock = Mockery::mock(Sound::class);
        $mock->shouldReceive('emit')
            ->once();
        App::bind(Sound::class, function ($app, $bind_params) use (&$params, $mock) {
            $params = $bind_params;
            return $mock;
        });

        $dog = new Dog();
        $dog->bark();

        $this->assertEquals(['animal' => $dog], $params);
    }
}
```

The obvious drawback to the version that doesn't use Better Bind is that there are extra lines, and one of them is very verbose. The secret extra drawback here is that nothing tests to ensure that the requirements to the real `Sound`class's constructor are met.

What will happen if you write the code from "Failing Code 1"?

```
class Dog
{
    public function bark()
    {
        App::makeWith(Sound::class, [$this])->emit();
    }
}
```

Laravel will detect that `Sound`'s constructor typehints an `Animal` object. But no 'animal' element is in the params, so Laravel will new up an `Animal`object to do the job. There will be no test failure.

Using Better Bind, the missing value will be detected and the test will fail.

If you *want* Laravel to fill in a new `Animal` object itself, you can add `->ignoreParameters('animal')`.

Compatibility
=============

[](#compatibility)

We believe this code is compatible with all versions of Laravel 5+ and Lumen 5+, but testing it is a chore because `make` changed to `makeWith` in 5.4 just to confuse everybody. Drop us a line and let us know how great it is and what version of Laravel you're working with.

Contribution
============

[](#contribution)

If you find a bug or want to contribute to the code or documentation, you can help by submitting an [issue](https://github.com/thatsus/laravel-better-bind/issues) or a [pull request](https://github.com/thatsus/laravel-better-bind/pulls).

License
=======

[](#license)

[MIT](http://opensource.org/licenses/MIT)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity63

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 ~1 days

Total

5

Last Release

2792d ago

Major Versions

v0.3.0 → v1.0.02018-09-17

### Community

Maintainers

![](https://www.gravatar.com/avatar/eb711bf9c5107c5de3104691c826c451390970e7f4500a66b9f384efadc7d351?d=identicon)[thatsus](/maintainers/thatsus)

---

Top Contributors

[![dankuck](https://avatars.githubusercontent.com/u/277837?v=4)](https://github.com/dankuck "dankuck (6 commits)")

---

Tags

laravelbindautomated tests

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/thatsus-laravel-better-bind/health.svg)

```
[![Health](https://phpackages.com/badges/thatsus-laravel-better-bind/health.svg)](https://phpackages.com/packages/thatsus-laravel-better-bind)
```

###  Alternatives

[slowlyo/owl-admin

基于 laravel、amis 开发的后台框架~

61214.2k26](/packages/slowlyo-owl-admin)[erag/laravel-disposable-email

A Laravel package to detect and block disposable email addresses.

226102.4k](/packages/erag-laravel-disposable-email)[highsolutions/eloquent-sequence

A Laravel package for easy creation and management sequence support for Eloquent models with elastic configuration.

121130.3k](/packages/highsolutions-eloquent-sequence)[glhd/linen

21135.6k](/packages/glhd-linen)

PHPackages © 2026

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