Using Eloquent in Slim Framework

Eloquent is one of the easier ORMs to get started with, so let's look at how to use and test it within a Slim Framework application.

Set up

You can add Eloquent to your Slim project via composer:

You now need to bootstrap it. To do this we need some settings, so lets do that in our standard Slim configuration:

We then instantiate the capsule manager and boot Eloquent , probably in index.php:

From this point, you can simply follow the documentation to create your Eloquent models and use them within your route callables.

Testing your models

At first glance, it seems quite hard to test your models as the find method is a static.

For example, consider this route callback within an action class:

To test it, I followed a tip from Taylor Otwell and wrapped the find method in a class that I could then mock:

The callback then becomes:

Like the view, the authorRepository is injected into the constructor and so can be mocked out. The full class looks like this:

To test using PHPUnit, we start by creating a mock for the AuthorRepository:

Then we set the expectation that the all method will return a collection of Authors:

We do the same for the view object:

Now we can instantiate the action class with our two mock objects. We then create a request and response objects and run the action and test the returned response:


Eloquent is quite a nice implementation of the Active Record pattern. If that meets your needs, then it is easy to use within a Slim Framework application, so go for it!

4 thoughts on “Using Eloquent in Slim Framework

  1. Thanks for sharing such a straightforward and easy-to-understand introduction!

    Even so, I have a suggestion: don't set an expectation on the queries in your tests, unless the point of the test is to show that the client (controller, I imagine) is issuing that specific query based on the incoming request (example: for a report run on April 2, 2016, verify that the controller calls "find all orders pending as of April 2, 2016", because getting that parameter right matters). If, instead, you simply want to check that the client handles the various results of the query (0 authors, 1 author, 1.4 million authors, raising an error), then merely stub the query. Setting expectations on queries is one path that leads toward the kind of brittle tests that make programmers hate test doubles. :) "Stub queries; expect actions/commands".

    Recommended reading:

Leave a Reply

Your email address will not be published. Required fields are marked *