Heads up! To view this whole video, sign in with your Courses account or enroll in your free 7-day trial. Sign In Enroll
Preview
Start a free Courses trial
to watch this video
PHP Unit is built on assertions. These are actions that state something forcefully. Assertions is just a fancy way of saying true or false. These assertions describe how the code-under-test is supposed to be working. The vast majority of tests you write using PHPUnit will be using assertions.
Step 1
Install PHPUnit
composer require --dev phpunit/phpunit ^8
Step 2
Create a test folder and add your first test file, ending with Test.php
tests/FirstTest.php
Step 3
Add a class that extends from the PHPUnit\Framework\TestCase class.
class FirstTest extends PHPUnit\Framework\TestCase
{
}
Step 4
Add a test function, either named with "test" at the beginning, or using the @test annotation.
/** @test */
function firstAssertion()
{
$this->assertTrue(false);
}
Let's start with a search for PHP Unit.
0:00
The first result,
it's PHPUnit.de which is what we want.
0:04
We're going to choose
Getting Started at the top, and
0:09
then we see the versions
four through eight.
0:12
The version you choose is based off
which PHP version you have installed.
0:15
Since I'm using PHP 7.2 or
later, I can go with PHPUnit 8.
0:19
Like any good package,
PHPUnit can be installed with Composer.
0:25
Two things to know, first, it is not
recommended to install PHPUnit globally.
0:30
You should install it per project.
0:37
Second, PHP unit is for
0:39
testing on your development environment
before you pushed production.
0:41
So we want to install this for
development using the dev flag.
0:47
We'll be working in Visual Studio code
where we have a built-in terminal.
0:52
We're in a new empty
directory named TESTING.
0:57
From within this folder we can run
composer require --dev phpunit/phpunit ^8.
1:00
Once PHP Unit is installed,
we're ready to write our first test.
1:10
PHP unit is built on assertions.
1:15
These are actions that
state something forcefully.
1:18
Assertions are just a fancy
way of saying true or false.
1:22
These assertions describe how the code
on your test is supposed to be working.
1:26
The vast majority of test that you write
using PHP unit will be using assertions.
1:32
There are some edge cases when dealing
with testing for exceptions to be thrown.
1:38
The simplest test and
the good starting point or
1:43
temporary place order is assertTrue
(false), that's it, very simple.
1:46
These assertions either fail or pass.
1:52
They're either true or false.
1:56
Since false is not true,
this assertion would fail.
1:58
To translate it into php unit, it looks
like this, $this->assertTrue(false);.
2:02
Let's write this as our first test.
2:09
We'll start by creating
a folder named tests.
2:12
Then we'll add a new class
file named FirstTest.php.
2:18
We'll define a class named
FirstTest that extends,
2:26
PHP unit, framework, Test case.
2:33
Then we can write a function for
each test.
2:41
We'll start with our true false assertion.
2:44
Create a new function
named first assertion.
2:47
Then we can call this assertTrue and
pass false.
2:53
Now we want to run our test.
3:01
PHP unit is primarily
a command line script, so
3:03
we'll be in our terminal just
like we were for composer.
3:06
From here,
we can run vendor/bin/phpunit and
3:09
then the path to our test file,
tests/FirstTest.php.
3:15
I get a warning that no tests were found.
3:21
By default, if I don't start my function
name with test, it won't be run as a test.
3:25
Let's add a second function.
3:31
Test second assertion.
3:36
And we'll add this,
assertTrue again And pass false.
3:43
If everything works,
we'll see our first failure.
3:53
A failed test is marked with an F,
and the message is displayed below.
3:57
Failed asserting that false is true.
4:04
Let's create a third assertion.
4:07
This time, instead of studying
our function name with test,
4:10
we have a second option.
4:14
We can use annotation in a method stuck
block to market as a test method.
4:15
Test, and now we can say function,
4:23
third assertion.
4:28
This time we'll use this->assertTrue and
pass true.
4:31
Now we see that we are running two tests.
4:37
The first one fails with an F and
the second one passes showing a dot.
4:41
We also continue to see a failure message.
4:47
Let's run the example from
the PHP unit Getting Started page
4:51
You need to sign up for Treehouse in order to download course files.
Sign up