Laravel Facades and Mockery, testing chained methods

Laravel Facades and Mockery, testing chained methods

🤔 How this happened

I was trying to play with PHPUnit and Laravel. And I had this need to test Laravel Facades. Those were using a chained method.

namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
class ChainController extends Controller
public function index(Request $request)
Storage::disk('local')->put('/images/content', $request->file('demo'));
return response()->json(['success' => true]);

So, after this, my tests failed because it says that it can execute put on null . That meant, for some reason, the disk method was returning null, which I know wasn’t true.

🔨 Solution

After some research. I found in the Mockery documentation (wich is what Laravel is using), that you need to specify to Mockery what’s returning your mocked function. In the following line, if I don’t set the return, it will be null by default. And will cause next assertions to fail.


The solution to this comes from a simple method from Mockery andReturnSelf . Notice this depends on your class implementation, but the majority of chained methods would return the class by itself. Otherwise, you can use andReturn and write the object, string, array or data structure that the Mock will return.

For this specific case, I needed andReturnSelf . Let’s see how the final result works. To test it, my ChainController is connected to the POST /chain route.

namespace Tests\Feature;
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
use Tests\TestCase;
class ChainControllerTest extends TestCase
public function test_using_facades()
$response = $this->post('/chain', ['demo' => UploadedFile::fake()->image('hello.jpeg')]);

đź”— Links

You can see a working example, click here

My posts are not AI generated, they might be only AI corrected. The first draft is always my creation



Written by Helmer Davila

In other languages

Usando el poder de Mockery

Laravel Facades y Mockery: Creando tests de métodos encadenados

On utilise la puissance de Mockery

Laravel Facades et Mockery: faire de tests sur des méthodes enchaînées

Related posts

A function often used in many Laravel projects

Adonis JS: Using Laravel Mix function

An issue between Laravel Dusk and your browser version

How to solve Laravel Dusk 500 session error