See rates for the top Laravel developers in Latin America

Data-driven testing with PHPUnit

Published on by

Data-driven testing with PHPUnit image

Testing your code is an essential part of the development process, but sometimes it could also be expensive when you try to emulate many uses cases based on a set of different input data.

In many cases, you could end up with a massive directory of tests repeating the same block of code over and over for each possible user interaction.

Take for example this case: Let’s say you are writing an application to transform markdown documents into HTML, so you probably need to handle at least the following methods:

- Transform h1 tags
- Transform code
- Transform links
- ...

Just to mention some of them.

One solution to add tests to each case would be having a method for each one of the Transformers:

class ExampleTest extends TestCase
{
/** @test */
public function transform_title()
{
//
}
 
/** @test */
public function transform_code()
{
//
}
 
/** @test */
public function transform_links()
{
//
}
}

What’s the problem with that?

In the previous example, it is more likely that all the methods would share the same structure: a given input, the transform method or class, and the expected output.

Now imagine if you have 50 different transformers in your application, this test file is going to be huge.

Introducing data-driven testing

TL;DR Data-driven testing (DDT) is a term used in the testing of computer software to describe testing done using a table of conditions directly as test inputs and verifiable outputs as well as the process where test environment settings and control are not hard-coded.

On this approach, you define a set of data that will drive your tests for each of the possible combinations.

$dataSet = [
['some A', TransformerA::class, 'expected output A'],
['some B', TransformerA::class, 'expected output B'],
['some C', TransformerA::class, 'expected output C'],
]

Then in your tests, you can use something like the following:

class ExampleTest extends TestCase
{
/** @test */
public function transform_content()
{
$dataSet = $this->dataSet();
 
foreach($dataSet as $data) {
$value = $data[0]
$class = new $data[1];
$expected = $data[2]
$this->assertEquals($expected, $class->process($value));
}
}
 
public function dataSet()
{
return [
['# Title #', TitleTransformer::class, '<h1>Title</h1>'],
['`$var`', CodeTransformer::class, '$var'],
['[Link](https://laravel-news.com)', LinkTransformer::class, '<a href="https://laravel-news.com">Link</a>']
]
}
}

Here we are assuming that all the transformers class share the same interface or contract, with a process() method to handle the given input.

Data-driven testing an PHPUnit

Although this seems to be a good solution, PHPUnit has a more elegant way to work with this pattern.

PHPUnit uses some useful Annotations that you can use to simplify your code, for example instead of:

public function test_some_method_name()
{
 
}

PHPUnit uses the test prefix to identify which methods of a test class are test methods.

You can use:

/** @test **/
public function some_method_name()
{
 
}

In this case, you can remove the test_ prefix by adding a comment with the text @text to identify the testing method.

Now let’s use the @dataProvider Annotation in the previous example:

class ExampleTest extends TestCase
{
/*
* @test
* @dataprovider dataSet
*/
public function transform_content($input, $class, $expected)
{
$class = new $class;
$this-&gt;assertEquals($expected, $class-&gt;process($value));
}
 
public function dataSet()
{
return [
['# Title #', TitleTransformer::class, '<h1>Title</h1>'],
['`$var`', CodeTransformer::class, '$var'],
['[Link](https://laravel-news.com)', LinkTransformer::class, '<a href="https://laravel-news.com">Link</a>']
]
}
}

What’s happening here is that internally, PHPUnit is iterating over each set of data defined in the dataSet method, and passing each argument to the transform_content() method.

Now, if you receive a failure on any set of data, you’ll see something like this:

There was 1 failure:
 
1) TestsUnitExampleTest::transform_content with data set #1 ('# Title #', TitleTransformer::class, '<h1>Title</h1>')
...

As you can see, this can be very confusing, but we can improve it by adding a key name to each dataset like so:

public function dataSet()
{
return [
'Transform titles' =&gt; ['# Title #', TitleTransformer::class, '<h1>Title</h1>'],
'Transform code text' =&gt; ['`$var`', CodeTransformer::class, '$var'],
'Transform links' =&gt; ['[Link](https://laravel-news.com)', LinkTransformer::class, '<a href="https://laravel-news.com">Link</a>']
]
}

Then you can see something like the following in case of failure:

There was 1 failure:
 
1) TestsUnitExampleTest::transform_content with data set "Transform titles" ('# Title #', TitleTransformer::class, '<h1>Title</h1>')
...

Extra tip

You can even have a custom iterator by writing a class that implements the Iterator interface

use PHPUnitFrameworkTestCase;
 
class CustomIterator implements Iterator {
protected $key = 0;
protected $current;
 
public function __construct()
{
//
}
 
public function __destruct()
{
//
}
 
public function rewind()
{
//
}
 
public function valid() {
//
}
 
public function key()
{
//
}
 
public function current()
{
//
}
 
public function next()
{
//
}
}

Here you can learn more about how to use a data provider that returns an Iterator object.

This article was inspired by Paul Redmond and some of his work on this HTML to AMP package.

Jeff photo

I'm a full-stack web developer and a part-time writer.

You can find more of my writing on https://medium.com/@jeffochoa.

Cube

Laravel Newsletter

Join 40k+ other developers and never miss out on new tips, tutorials, and more.

image
Bacancy

Outsource a dedicated Laravel developer for $2,500/month. With over a decade of experience in Laravel development, we deliver fast, high-quality, and cost-effective solutions at affordable rates.

Visit Bacancy
Curotec logo

Curotec

World class Laravel experts with GenAI dev skills. LATAM-based, embedded engineers that ship fast, communicate clearly, and elevate your product. No bloat, no BS.

Curotec
Bacancy logo

Bacancy

Supercharge your project with a seasoned Laravel developer with 4-6 years of experience for just $2500/month. Get 160 hours of dedicated expertise & a risk-free 15-day trial. Schedule a call now!

Bacancy
Laravel Forge logo

Laravel Forge

Easily create and manage your servers and deploy your Laravel applications in seconds.

Laravel Forge
Tinkerwell logo

Tinkerwell

The must-have code runner for Laravel developers. Tinker with AI, autocompletion and instant feedback on local and production environments.

Tinkerwell
Cut PHP Code Review Time & Bugs into Half with CodeRabbit logo

Cut PHP Code Review Time & Bugs into Half with CodeRabbit

CodeRabbit is an AI-powered code review tool that specializes in PHP and Laravel, running PHPStan and offering automated PR analysis, security checks, and custom review features while remaining free for open-source projects.

Cut PHP Code Review Time & Bugs into Half with CodeRabbit
Join the Mastering Laravel community logo

Join the Mastering Laravel community

Connect with experienced developers in a friendly, noise-free environment. Get insights, share ideas, and find support for your coding challenges. Join us today and elevate your Laravel skills!

Join the Mastering Laravel community
Kirschbaum logo

Kirschbaum

Providing innovation and stability to ensure your web application succeeds.

Kirschbaum
Shift logo

Shift

Running an old Laravel version? Instant, automated Laravel upgrades and code modernization to keep your applications fresh.

Shift
Lucky Media logo

Lucky Media

Get Lucky Now - the ideal choice for Laravel Development, with over a decade of experience!

Lucky Media
Lunar: Laravel E-Commerce logo

Lunar: Laravel E-Commerce

E-Commerce for Laravel. An open-source package that brings the power of modern headless e-commerce functionality to Laravel.

Lunar: Laravel E-Commerce
LaraJobs logo

LaraJobs

The official Laravel job board

LaraJobs
SaaSykit: Laravel SaaS Starter Kit logo

SaaSykit: Laravel SaaS Starter Kit

SaaSykit is a Multi-tenant Laravel SaaS Starter Kit that comes with all features required to run a modern SaaS. Payments, Beautiful Checkout, Admin Panel, User dashboard, Auth, Ready Components, Stats, Blog, Docs and more.

SaaSykit: Laravel SaaS Starter Kit

The latest

View all →
Streamline Conditional Logic with Laravel's Fluent Conditionable Trait image

Streamline Conditional Logic with Laravel's Fluent Conditionable Trait

Read article
Sublime Text Releases Update With Support for Right Sidebar image

Sublime Text Releases Update With Support for Right Sidebar

Read article
Enhance Email Validation with Laravel's Fluent Email Rule Object image

Enhance Email Validation with Laravel's Fluent Email Rule Object

Read article
Locale-aware Number Parsing in Laravel 12.15 image

Locale-aware Number Parsing in Laravel 12.15

Read article
Handle Fluent Values as Arrays with Laravel's array() Method image

Handle Fluent Values as Arrays with Laravel's array() Method

Read article
Chargebee Starter Kit for Billing in Laravel image

Chargebee Starter Kit for Billing in Laravel

Read article