Chapters

20 Chapters | 1:32:53 |

01

POST To Create

7:47
02

Finish POST with a Form

4:42
03

Handling data with a Form

5:03
04

GET one Programmer

3:20
05

Tightening up the Response

3:51
06

GET a Collection of Programmers

5:24
07

Add a Test!

3:00
08

Test Code Reuse

2:31
09

Tests with the Container

4:23
10

Mad Test Debugging

3:03
11

Test Fixtures and the PropertyAccess Component

6:24
12

The ResponseAsserter!

6:21
13

Using a Test Database

6:52
14

PUT is for Updating

6:41
15

Read-Only Fields

3:26
16

DELETE is for Saying Goodbye

2:59
17

PATCH is (also) for Updating (basically)

3:18
18

Using a Serializer

5:47
19

Centralize that Response!

2:40
20

Taking Control of the Serializer

5:21

This tutorial has a new version, check it out!

> APIs > Symfony RESTful API: Course 1

Buy Access to Course

07.

Add a Test!

Autoplay

Keep on Learning!

If you liked what you've learned so far, dive in! Subscribe to get
access to this tutorial plus video, code and script downloads.

Start your All-Access Pass

Buy just this tutorial for $10.00

Previous Chapter

Next Chapter

With a Subscription, click any sentence in the script to jump to that part of the video!

This testing.php file is basically already a test... except it's missing the most important part: the ability to start shouting when something breaks.

To test our API, we'll use PHPUnit! Yes! Awesome! I'm excited because even though PHPUnit isn't the most exciting tool, it's solid - and we're going to do some cool stuff with our tests.

TIP In our other REST tutorial, we tested with Behat. Both are great, and really the same under the surface.

Create that Test

Create a Tests directory inside AppBundle. Now mimic your directory structure. So, add a Controller directory, then an API directory, and finish it with a new PHPUnit test class for ProgrammerController. Be a good programmer and fill in the right namespace. All these directories: technically unnecessary. But now we've got a sane setup.

Of course, we'll test our POST endpoint - so create public function testPOST():

            Copy Code

                            Show All Lines

                        28 lines
            |
            src/AppBundle/Tests/Controller/Api/ProgrammerControllerTest.php
        
            <?php
        
            namespace AppBundle\Tests\Controller\Api;
        
            class ProgrammerControllerTest extends \PHPUnit_Framework_TestCase
        
            {
        
                public function testPOST()
        
                {
        
                Show Lines

                                                    // ... lines 8 - 25
                            
                }
        
            }

I'm being inconsistent - the controller is newAction, but this method is testPOST - it would be cool to have these match - maybe even with a mixture of the two - like postNewAction().

Anyways, let's go steal our first request code from testing.php and paste it into testPOST:

            Copy Code

                            Show All Lines

                        28 lines
            |
            src/AppBundle/Tests/Controller/Api/ProgrammerControllerTest.php
        
                Show Lines

                                                    // ... lines 1 - 5
                            
                public function testPOST()
        
                {
        
                    $client = new \GuzzleHttp\Client([
        
                        'base_url' => 'http://localhost:8000',
        
                        'defaults' => [
        
                            'exceptions' => false
        
                        ]
        
                    ]);
        
                    $nickname = 'ObjectOrienter'.rand(0, 999);
        
                    $data = array(
        
                        'nickname' => $nickname,
        
                        'avatarNumber' => 5,
        
                        'tagLine' => 'a test dev!'
        
                    );
        
                    // 1) Create a programmer resource
        
                    $response = $client->post('/api/programmers', [
        
                        'body' => json_encode($data)
        
                    ]);
        
                }
        
                Show Lines

                                                    // ... lines 27 - 28

Ok cool. No asserts yet - but let's see if it blows up. I already installed PHPUnit into this project, so run php bin/phpunit -c app then the path to the test:

php bin/phpunit -c app src/AppBundle/Tests/Controller/Api/ProgrammerControllerTest.php

Pretty green! No assertions yet, but also no explosions. Solid start team!

Be Assertive

Ok, what should we assert? Always start with the status code - $this->assertEquals() that the expected 201 equals $response->getStatusCode():

            Copy Code

                            Show All Lines

                        33 lines
            |
            src/AppBundle/Tests/Controller/Api/ProgrammerControllerTest.php
        
                Show Lines

                                                    // ... lines 1 - 21
                            
                    // 1) Create a programmer resource
        
                    $response = $client->post('/api/programmers', [
        
                        'body' => json_encode($data)
        
                    ]);
        
                    $this->assertEquals(201, $response->getStatusCode());
        
                Show Lines

                                                    // ... lines 28 - 33

Second: what response header should we send back whenever we create a resource? Location! Right now, just assertTrue that $response->hasHeader('Location'). Soon, we'll assert the actual value.

            Copy Code

                            Show All Lines

                        33 lines
            |
            src/AppBundle/Tests/Controller/Api/ProgrammerControllerTest.php
        
                Show Lines

                                                    // ... lines 1 - 26
                            
                    $this->assertEquals(201, $response->getStatusCode());
        
                    $this->assertTrue($response->hasHeader('Location'));
        
                Show Lines

                                                    // ... lines 29 - 33

And to put a bow on things, let's json_decode the response body into an array, and just assert that is has a nickname key with assertArrayHasKey, with nickname and $data:

            Copy Code

                            Show All Lines

                        33 lines
            |
            src/AppBundle/Tests/Controller/Api/ProgrammerControllerTest.php
        
                Show Lines

                                                    // ... lines 1 - 26
                            
                    $this->assertEquals(201, $response->getStatusCode());
        
                    $this->assertTrue($response->hasHeader('Location'));
        
                    $finishedData = json_decode($response->getBody(true), true);
        
                    $this->assertArrayHasKey('nickname', $finishedData);
        
                Show Lines

                                                    // ... lines 31 - 33

In a second, we'll assert the actual value. It's not a super-tight test yet, but let's give it a shot:

php bin/phpunit -c app src/AppBundle/Tests/Controller/Api/ProgrammerControllerTest.php

Yes! This time we deserve that green.

8 Comments

Sort By

Miguel Angel Carvajal Rivero 6 years ago

I am getting the following error
GuzzleHttp\Exception\RequestException : cURL error 3: <url> malformed when configuring the test

1 | Reply |

Victor SFCASTS Miguel Angel Carvajal Rivero 6 years ago edited

Hey Miguel,

I bet you have bad URL for your request. What's it? Is it something relative like '/'? Try to use absolute URL. Does it fix you problem?

P.S. You can disable verification with: $response = $client->get('https://api.github.com/', ['verify' => false]);, but better do not do this.

Cheers!

| Reply |

Александр Victor 5 years ago

base_uri, not base_url

| Reply |

Victor SFCASTS Александр 5 years ago

Hey Alexandr,

Thank you for this tip! Yeah, in a newer version of Guzzle (newer than we use in this course) they renamed "base_url" -> "base_uri".

Cheers!

| Reply |

Shaun T. 6 years ago

In my app I am using Doctrine Blameable Extension, so it sets the current user when creating a post on the createdBy field.

How can I handle this when running my tests?

| Reply |

Victor SFCASTS Shaun T. 6 years ago

Hey Shaun,

You probably need an integration test, but it depends on tools you use. I suppose you use PHPUnit, so take a look at functional tests: http://symfony.com/doc/curr... . You need to authenticate user, create a new post and then check that the post has the current user in createdBy field.

Cheers!

| Reply |

Mike Milano 6 years ago

I was getting the error: "Failed to connect to localhost port 80:", even though I was specifying `http://localhost:8000`.

I resolved this by changing `base_url` to `base_uri` in the config of the GuzzleHttp Client constructor.

Also, echoing the response was not working. I had to `echo $response->getBody();`

I am running PHP 7.1 locally. Perhaps this or Guzzle changes since this video was produced are factors.

| Reply |

MolloKhan SFCASTS Mike Milano 6 years ago edited

Hey Mike Milano

You are absolutely right, Guzzle has changed a bit since the tutorial was recorded. Thanks for informing us, we will add a note to the video to prevent other users from this "What a heck" moment

Cheers!

| Reply |

This tutorial uses an older version of Symfony. The concepts of REST are still valid, but I recommend using API Platform in new Symfony apps.

Symfony 2

What PHP libraries does this tutorial use?

// composer.json
{
    "require": {
        "php": ">=5.3.3",
        "symfony/symfony": "2.6.*", // v2.6.11
        "doctrine/orm": "~2.2,>=2.2.3,<2.5", // v2.4.7
        "doctrine/dbal": "<2.5", // v2.4.4
        "doctrine/doctrine-bundle": "~1.2", // v1.4.0
        "twig/extensions": "~1.0", // v1.2.0
        "symfony/assetic-bundle": "~2.3", // v2.6.1
        "symfony/swiftmailer-bundle": "~2.3", // v2.3.8
        "symfony/monolog-bundle": "~2.4", // v2.7.1
        "sensio/distribution-bundle": "~3.0,>=3.0.12", // v3.0.21
        "sensio/framework-extra-bundle": "~3.0,>=3.0.2", // v3.0.7
        "incenteev/composer-parameter-handler": "~2.0", // v2.1.0
        "hautelook/alice-bundle": "0.2.*", // 0.2
        "jms/serializer-bundle": "0.13.*" // 0.13.0
    },
    "require-dev": {
        "sensio/generator-bundle": "~2.3", // v2.5.3
        "behat/behat": "~3.0", // v3.0.15
        "behat/mink-extension": "~2.0.1", // v2.0.1
        "behat/mink-goutte-driver": "~1.1.0", // v1.1.0
        "behat/mink-selenium2-driver": "~1.2.0", // v1.2.0
        "phpunit/phpunit": "~4.6.0" // 4.6.4
    }
}

Previous Chapter

Next Chapter

Add a Test!

Share this awesome video!

Keep on Learning!

Create that Test

Be Assertive

8 Comments

Delete comment?

What PHP libraries does this tutorial use?

	<?php
	namespace AppBundle\Tests\Controller\Api;

	class ProgrammerControllerTest extends \PHPUnit_Framework_TestCase
	{
	public function testPOST()
	{
Show Lines	// ... lines 8 - 25
	}
	}

Show Lines	// ... lines 1 - 5
	public function testPOST()
	{
	$client = new \GuzzleHttp\Client([
	'base_url' => 'http://localhost:8000',
	'defaults' => [
	'exceptions' => false
	]
	]);

	$nickname = 'ObjectOrienter'.rand(0, 999);
	$data = array(
	'nickname' => $nickname,
	'avatarNumber' => 5,
	'tagLine' => 'a test dev!'
	);

	// 1) Create a programmer resource
	$response = $client->post('/api/programmers', [
	'body' => json_encode($data)
	]);
	}
Show Lines	// ... lines 27 - 28

Show Lines	// ... lines 1 - 21
	// 1) Create a programmer resource
	$response = $client->post('/api/programmers', [
	'body' => json_encode($data)
	]);

	$this->assertEquals(201, $response->getStatusCode());
Show Lines	// ... lines 28 - 33

Show Lines	// ... lines 1 - 26
	$this->assertEquals(201, $response->getStatusCode());
	$this->assertTrue($response->hasHeader('Location'));
Show Lines	// ... lines 29 - 33