Testing
Whenever you write a new line of code, you also potentially add new bugs.To build better and more reliable applications, you should test your codeusing both functional and unit tests.
The PHPUnit Testing Framework
Symfony integrates with an independent library called PHPUnit to give you arich testing framework. This article won't cover PHPUnit itself, which has itsown excellent documentation.
Before creating your first test, install the PHPUnit Bridge component, whichwraps the original PHPUnit binary to provide additional features:
- $ composer require --dev symfony/phpunit-bridge
Each test - whether it's a unit test or a functional test - is a PHP classthat should live in the tests/
directory of your application. If you followthis rule, then you can run all of your application's tests with the followingcommand:
- $ ./bin/phpunit
Note
The ./bin/phpunit
command is created by Symfony Flexwhen installing the phpunit-bridge
package. If the command is missing, youcan remove the package (composer remove symfony/phpunit-bridge
) and installit again. Another solution is to remove the project's symfony.lock
file andrun composer install
to force the execution of all Symfony Flex recipes.
PHPUnit is configured by the phpunit.xml.dist
file in the root of yourSymfony application.
Tip
Code coverage can be generated with the —coverage-*
options, see thehelp information that is shown when using —help
for more information.
Unit Tests
A unit test is a test against a single PHP class, also called a unit. If youwant to test the overall behavior of your application, see the section aboutFunctional Tests.
Writing Symfony unit tests is no different from writing standard PHPUnitunit tests. Suppose, for example, that you have an incredibly simple classcalled Calculator
in the src/Util/
directory of the app:
- // src/Util/Calculator.php
- namespace App\Util;
- class Calculator
- {
- public function add($a, $b)
- {
- return $a + $b;
- }
- }
To test this, create a CalculatorTest
file in the tests/Util
directoryof your application:
- // tests/Util/CalculatorTest.php
- namespace App\Tests\Util;
- use App\Util\Calculator;
- use PHPUnit\Framework\TestCase;
- class CalculatorTest extends TestCase
- {
- public function testAdd()
- {
- $calculator = new Calculator();
- $result = $calculator->add(30, 12);
- // assert that your calculator added the numbers correctly!
- $this->assertEquals(42, $result);
- }
- }
Note
By convention, the tests/
directory should replicate the directoryof your bundle for unit tests. So, if you're testing a class in thesrc/Util/
directory, put the test in the tests/Util/
directory.
Just like in your real application - autoloading is automatically enabledvia the vendor/autoload.php
file (as configured by default in thephpunit.xml.dist
file).
You can also limit a test run to a directory or a specific test file:
- # run all tests of the application
- $ php bin/phpunit
- # run all tests in the Util/ directory
- $ php bin/phpunit tests/Util
- # run tests for the Calculator class
- $ php bin/phpunit tests/Util/CalculatorTest.php
Functional Tests
Functional tests check the integration of the different layers of anapplication (from the routing to the views). They are no different from unittests as far as PHPUnit is concerned, but they have a very specific workflow:
- Make a request;
- Click on a link or submit a form;
- Test the response;
- Rinse and repeat.Before creating your first test, install these packages that provide some of theutilities used in the functional tests:
- $ composer require --dev symfony/browser-kit symfony/css-selector
Your First Functional Test
Functional tests are PHP files that typically live in the tests/Controller
directory for your bundle. If you want to test the pages handled by yourPostController
class, start by creating a new PostControllerTest.php
file that extends a special WebTestCase
class.
As an example, a test could look like this:
- // tests/Controller/PostControllerTest.php
- namespace App\Tests\Controller;
- use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
- class PostControllerTest extends WebTestCase
- {
- public function testShowPost()
- {
- $client = static::createClient();
- $client->request('GET', '/post/hello-world');
- $this->assertEquals(200, $client->getResponse()->getStatusCode());
- }
- }
Tip
To run your functional tests, the WebTestCase
class needs to know whichis the application kernel to bootstrap it. The kernel class is usuallydefined in the KERNEL_CLASS
environment variable (included in thedefault .env.test
file provided by Symfony):
If your use case is more complex, you can also override thecreateKernel()
or getKernelClass()
methods of your functional test,which take precedence over the KERNEL_CLASS
env var.
In the above example, you validated that the HTTP response was successful. Thenext step is to validate that the page actually contains the expected content.The createClient()
method returns a client, which is like a browser thatyou'll use to crawl your site:
- $crawler = $client->request('GET', '/post/hello-world');
The request()
method (readmore about the request method)returns a Crawler
object which canbe used to select elements in the response, click on links and submit forms.
Tip
The Crawler
only works when the response is an XML or an HTML document.To get the raw content response, call $client->getResponse()->getContent()
.
The crawler integrates with the symfony/css-selector
component to give you thepower of CSS selectors to find content in a page. To install the CSS selectorcomponent, run:
- $ composer require --dev symfony/css-selector
Now you can use CSS selectors with the crawler. To assert that the phrase"Hello World" is present in the page's main title, you can use this assertion:
- $this->assertSelectorTextContains('html h1.title', 'Hello World');
This assertion will internally call $crawler->filter('html h1.title')
, which allowsyou to use CSS selectors to filter any HTML element in the page and check forits existence, attributes, text, etc.
The assertSelectorTextContains
method is not a native PHPUnit assertion and isavailable thanks to the WebTestCase
class.
New in version 4.3: The WebTestCase
assertions were introduced in Symfony 4.3
Using native PHPUnit methods, the same assertion would look like this:
- $this->assertGreaterThan(
- 0,
- $crawler->filter('html h1.title:contains("Hello World")')->count()
- );
The crawler can also be used to interact with the page. Click on a link by firstselecting it with the crawler using either an XPath expression or a CSS selector,then use the client to click on it:
- $link = $crawler
- ->filter('a:contains("Greet")') // find all links with the text "Greet"
- ->eq(1) // select the second link in the list
- ->link()
- ;
- // and click it
- $crawler = $client->click($link);
Submitting a form is very similar: select a form button, optionally overridesome form values and submit the corresponding form:
- $form = $crawler->selectButton('submit')->form();
- // set some values
- $form['name'] = 'Lucas';
- $form['form_name[subject]'] = 'Hey there!';
- // submit the form
- $crawler = $client->submit($form);
Tip
The form can also handle uploads and contains methods to fill in different typesof form fields (e.g. select()
and tick()
). For details, see theForms section below.
Now that you can navigate through an application, use assertions to testthat it actually does what you expect it to. Use the Crawler to make assertionson the DOM:
- // asserts that the response matches a given CSS selector.
- $this->assertGreaterThan(0, $crawler->filter('h1')->count());
Or test against the response content directly if you just want to assert thatthe content contains some text or in case that the response is not an XML/HTMLdocument:
- $this->assertContains(
- 'Hello World',
- $client->getResponse()->getContent()
- );
Tip
Instead of installing each testing dependency individually, you can use thetest
Symfony pack to install all those dependencies at once:
- $ composer require --dev symfony/test-pack
Useful Assertions
To get you started faster, here is a list of the most common anduseful test assertions:
- use Symfony\Component\HttpFoundation\Response;
- // ...
- // asserts that there is at least one h2 tag
- // with the class "subtitle"
- $this->assertGreaterThan(
- 0,
- $crawler->filter('h2.subtitle')->count()
- );
- // asserts that there are exactly 4 h2 tags on the page
- $this->assertCount(4, $crawler->filter('h2'));
- // asserts that the "Content-Type" header is "application/json"
- $this->assertTrue(
- $client->getResponse()->headers->contains(
- 'Content-Type',
- 'application/json'
- ),
- 'the "Content-Type" header is "application/json"' // optional message shown on failure
- );
- // asserts that the response content contains a string
- $this->assertContains('foo', $client->getResponse()->getContent());
- // ...or matches a regex
- $this->assertRegExp('/foo(bar)?/', $client->getResponse()->getContent());
- // asserts that the response status code is 2xx
- $this->assertTrue($client->getResponse()->isSuccessful(), 'response status is 2xx');
- // asserts that the response status code is 404
- $this->assertTrue($client->getResponse()->isNotFound());
- // asserts a specific 200 status code
- $this->assertEquals(
- 200, // or Symfony\Component\HttpFoundation\Response::HTTP_OK
- $client->getResponse()->getStatusCode()
- );
- // asserts that the response is a redirect to /demo/contact
- $this->assertTrue(
- $client->getResponse()->isRedirect('/demo/contact')
- // if the redirection URL was generated as an absolute URL
- // $client->getResponse()->isRedirect('http://localhost/demo/contact')
- );
- // ...or simply check that the response is a redirect to any URL
- $this->assertTrue($client->getResponse()->isRedirect());
Testing against Different Sets of Data
It's common to have to execute the same test against different sets of data tocheck the multiple conditions code must handle. This is solved with PHPUnit'sdata providers, which work both for unit and functional tests.
First, add one or more arguments to your test method and use them inside thetest code. Then, define another method which returns a nested array with thearguments to use on each test run. Lastly, add the @dataProvider
annotationto associate both methods:
- /**
- * @dataProvider provideUrls
- */
- public function testPageIsSuccessful($url)
- {
- $client = self::createClient();
- $client->request('GET', $url);
- $this->assertTrue($client->getResponse()->isSuccessful());
- }
- public function provideUrls()
- {
- return [
- ['/'],
- ['/blog'],
- ['/contact'],
- // ...
- ];
- }
Working with the Test Client
The test client simulates an HTTP client like a browser and makes requestsinto your Symfony application:
- $crawler = $client->request('GET', '/post/hello-world');
The request()
method takes the HTTP method and a URL as arguments andreturns a Crawler
instance.
Tip
Hardcoding the request URLs is a best practice for functional tests. If thetest generates URLs using the Symfony router, it won't detect any changemade to the application URLs which may impact the end users.
More about the request()
Method:
The full signature of the request()
method is:
- request(
- $method,
- $uri,
- array $parameters = [],
- array $files = [],
- array $server = [],
- $content = null,
- $changeHistory = true
- )
The server
array is the raw values that you'd expect to normallyfind in the PHP $_SERVER superglobal. For example, to set theContent-Type
and Referer
HTTP headers, you'd pass the following (mindthe HTTP_
prefix for non standard headers):
- $client->request(
- 'GET',
- '/post/hello-world',
- [],
- [],
- [
- 'CONTENT_TYPE' => 'application/json',
- 'HTTP_REFERER' => '/foo/bar',
- ]
- );
Use the crawler to find DOM elements in the response. These elements can thenbe used to click on links and submit forms:
- $crawler = $client->clickLink('Go elsewhere...');
- $crawler = $client->submitForm('validate', ['name' => 'Fabien']);
The clickLink()
and submitForm()
methods both return a Crawler
object.These methods are the best way to browse your application as it takes careof a lot of things for you, like detecting the HTTP method from a form andgiving you a nice API for uploading files.
The request()
method can also be used to simulate form submissions directlyor perform more complex requests. Some useful examples:
- // submits a form directly (but using the Crawler is easier!)
- $client->request('POST', '/submit', ['name' => 'Fabien']);
- // submits a raw JSON string in the request body
- $client->request(
- 'POST',
- '/submit',
- [],
- [],
- ['CONTENT_TYPE' => 'application/json'],
- '{"name":"Fabien"}'
- );
- // Form submission with a file upload
- use Symfony\Component\HttpFoundation\File\UploadedFile;
- $photo = new UploadedFile(
- '/path/to/photo.jpg',
- 'photo.jpg',
- 'image/jpeg',
- null
- );
- $client->request(
- 'POST',
- '/submit',
- ['name' => 'Fabien'],
- ['photo' => $photo]
- );
- // Perform a DELETE request and pass HTTP headers
- $client->request(
- 'DELETE',
- '/post/12',
- [],
- [],
- ['PHP_AUTH_USER' => 'username', 'PHP_AUTH_PW' => 'pa$$word']
- );
Last but not least, you can force each request to be executed in its own PHPprocess to avoid any side effects when working with several clients in the samescript:
- $client->insulate();
AJAX Requests
The Client provides a xmlHttpRequest()
method, which has the same arguments as the request()
method, and it's ashortcut to make AJAX requests:
- // the required HTTP_X_REQUESTED_WITH header is added automatically
- $client->xmlHttpRequest('POST', '/submit', ['name' => 'Fabien']);
Browsing
The Client supports many operations that can be done in a real browser:
- $client->back();
- $client->forward();
- $client->reload();
- // clears all cookies and the history
- $client->restart();
Note
The back()
and forward()
methods skip the redirects that may haveoccurred when requesting a URL, as normal browsers do.
Accessing Internal Objects
If you use the client to test your application, you might want to access theclient's internal objects:
- $history = $client->getHistory();
- $cookieJar = $client->getCookieJar();
You can also get the objects related to the latest request:
- // the HttpKernel request instance
- $request = $client->getRequest();
- // the BrowserKit request instance
- $request = $client->getInternalRequest();
- // the HttpKernel response instance
- $response = $client->getResponse();
- // the BrowserKit response instance
- $response = $client->getInternalResponse();
- $crawler = $client->getCrawler();
Accessing the Container
It's highly recommended that a functional test only tests the response. Butunder certain very rare circumstances, you might want to access some servicesto write assertions. Given that services are private by default, test classesdefine a property that stores a special container created by Symfony whichallows fetching both public and all non-removed private services:
- // gives access to the same services used in your test, unless you're using
- // $client->insulate() or using real HTTP requests to test your application
- $container = self::$container;
For a list of services available in your application, use the debug:container
command.
Tip
The special container that gives access to private services exists only inthe test
environment and is itself a service that you can get from thereal container using the test.service_container
id.
Tip
If the information you need to check is available from the profiler, useit instead.
Accessing the Profiler Data
On each request, you can enable the Symfony profiler to collect data about theinternal handling of that request. For example, the profiler could be used toverify that a given page executes less than a certain number of databasequeries when loading.
To get the Profiler for the last request, do the following:
- // enables the profiler for the very next request
- $client->enableProfiler();
- $crawler = $client->request('GET', '/profiler');
- // gets the profile
- $profile = $client->getProfile();
For specific details on using the profiler inside a test, see theHow to Use the Profiler in a Functional Test article.
Redirecting
When a request returns a redirect response, the client does not followit automatically. You can examine the response and force a redirectionafterwards with the followRedirect()
method:
- $crawler = $client->followRedirect();
If you want the client to automatically follow all redirects, you canforce them by calling the followRedirects()
method before performing the request:
- $client->followRedirects();
If you pass false
to the followRedirects()
method, the redirectswill no longer be followed:
- $client->followRedirects(false);
Reporting Exceptions
Debugging exceptions in functional tests may be difficult because by defaultthey are caught and you need to look at the logs to see which exception wasthrown. Disabling catching of exceptions in the test client allows the exceptionto be reported by PHPUnit:
- $client->catchExceptions(false);
The Crawler
A Crawler instance is returned each time you make a request with the Client.It allows you to traverse HTML documents, select nodes, find links and forms.
Traversing
Like jQuery, the Crawler has methods to traverse the DOM of an HTML/XMLdocument. For example, the following finds all input[type=submit]
elements,selects the last one on the page, and then selects its immediate parent element:
- $newCrawler = $crawler->filter('input[type=submit]')
- ->last()
- ->parents()
- ->first()
- ;
Many other methods are also available:
filter('h1.title')
- Nodes that match the CSS selector.
filterXpath('h1')
- Nodes that match the XPath expression.
eq(1)
- Node for the specified index.
first()
- First node.
last()
- Last node.
siblings()
- Siblings.
nextAll()
- All following siblings.
previousAll()
- All preceding siblings.
parents()
- Returns the parent nodes.
children()
- Returns children nodes.
reduce($lambda)
- Nodes for which the callable does not return false.Since each of these methods returns a new
Crawler
instance, you cannarrow down your node selection by chaining the method calls:
- $crawler
- ->filter('h1')
- ->reduce(function ($node, $i) {
- if (!$node->attr('class')) {
- return false;
- }
- })
- ->first()
- ;
Tip
Use the count()
function to get the number of nodes stored in a Crawler:count($crawler)
Extracting Information
The Crawler can extract information from the nodes:
- // returns the attribute value for the first node
- $crawler->attr('class');
- // returns the node value for the first node
- $crawler->text();
- // extracts an array of attributes for all nodes
- // (_text returns the node value)
- // returns an array for each element in crawler,
- // each with the value and href
- $info = $crawler->extract(['_text', 'href']);
- // executes a lambda for each node and return an array of results
- $data = $crawler->each(function ($node, $i) {
- return $node->attr('href');
- });
Links
Use the clickLink()
method to click on the first link that contains thegiven text (or the first clickable image with that alt
attribute):
- $client = static::createClient();
- $client->request('GET', '/post/hello-world');
- $client->clickLink('Click here');
If you need access to the Link
objectthat provides helpful methods specific to links (such as getMethod()
andgetUri()
), use the selectLink()
method instead:
- $client = static::createClient();
- $crawler = $client->request('GET', '/post/hello-world');
- $link = $crawler->selectLink('Click here')->link();
- $client->click($link);
Forms
Use the submitForm()
method to submit the form that contains the given button:
- $client = static::createClient();
- $client->request('GET', '/post/hello-world');
- $crawler = $client->submitForm('Add comment', [
- 'comment_form[content]' => '...',
- ]);
The first argument of submitForm()
is the text content, id
, value
orname
of any <button>
or <input type="submit">
included in the form.The second optional argument is used to override the default form field values.
Note
Notice that you select form buttons and not forms as a form can have severalbuttons; if you use the traversing API, keep in mind that you must look for abutton.
If you need access to the Form
objectthat provides helpful methods specific to forms (such as getUri()
,getValues()
and getFields()
) use the selectButton()
method instead:
- $client = static::createClient();
- $crawler = $client->request('GET', '/post/hello-world');
- $buttonCrawlerNode = $crawler->selectButton('submit');
- // select the form that contains this button
- $form = $buttonCrawlerNode->form();
- // you can also pass an array of field values that overrides the default ones
- $form = $buttonCrawlerNode->form([
- 'my_form[name]' => 'Fabien',
- 'my_form[subject]' => 'Symfony rocks!',
- ]);
- // you can pass a second argument to override the form HTTP method
- $form = $buttonCrawlerNode->form([], 'DELETE');
- // submit the Form object
- $client->submit($form);
The field values can also be passed as a second argument of the submit()
method:
- $client->submit($form, [
- 'my_form[name]' => 'Fabien',
- 'my_form[subject]' => 'Symfony rocks!',
- ]);
For more complex situations, use the Form
instance as an array to set thevalue of each field individually:
- // changes the value of a field
- $form['my_form[name]'] = 'Fabien';
- $form['my_form[subject]'] = 'Symfony rocks!';
There is also a nice API to manipulate the values of the fields according totheir type:
- // selects an option or a radio
- $form['country']->select('France');
- // ticks a checkbox
- $form['like_symfony']->tick();
- // uploads a file
- $form['photo']->upload('/path/to/lucas.jpg');
- // In the case of a multiple file upload
- $form['my_form[field][O]']->upload('/path/to/lucas.jpg');
- $form['my_form[field][1]']->upload('/path/to/lisa.jpg');
Tip
If you purposefully want to select "invalid" select/radio values, seeSelecting Invalid Choice Values.
Tip
You can get the values that will be submitted by calling the getValues()
method on the Form
object. The uploaded files are available in aseparate array returned by getFiles()
. The getPhpValues()
andgetPhpFiles()
methods also return the submitted values, but in thePHP format (it converts the keys with square brackets notation - e.g.my_form[subject]
- to PHP arrays).
Tip
The submit()
and submitForm()
methods define optional arguments toadd custom server parameters and HTTP headers when submitting the form:
- $client->submit($form, [], ['HTTP_ACCEPT_LANGUAGE' => 'es']);
- $client->submitForm($button, [], 'POST', ['HTTP_ACCEPT_LANGUAGE' => 'es']);
Adding and Removing Forms to a Collection
If you use a Collection of Forms,you can't add fields to an existing form with$form['task[tags][0][name]'] = 'foo';
. This results in an errorUnreachable field "…"
because $form
can only be used in order toset values of existing fields. In order to add new fields, you have toadd the values to the raw data array:
- // gets the form
- $form = $crawler->filter('button')->form();
- // gets the raw values
- $values = $form->getPhpValues();
- // adds fields to the raw values
- $values['task']['tags'][0]['name'] = 'foo';
- $values['task']['tags'][1]['name'] = 'bar';
- // submits the form with the existing and new values
- $crawler = $client->request($form->getMethod(), $form->getUri(), $values,
- $form->getPhpFiles());
- // the 2 tags have been added to the collection
- $this->assertEquals(2, $crawler->filter('ul.tags > li')->count());
Where task[tags][0][name]
is the name of a field createdwith JavaScript.
You can remove an existing field, e.g. a tag:
- // gets the values of the form
- $values = $form->getPhpValues();
- // removes the first tag
- unset($values['task']['tags'][0]);
- // submits the data
- $crawler = $client->request($form->getMethod(), $form->getUri(),
- $values, $form->getPhpFiles());
- // the tag has been removed
- $this->assertEquals(0, $crawler->filter('ul.tags > li')->count());
Testing Configuration
The Client used by functional tests creates a Kernel that runs in a specialtest
environment. Since Symfony loads the config/packages/test/*.yaml
in the test
environment, you can tweak any of your application's settingsspecifically for testing.
For example, by default, the Swift Mailer is configured to not actuallydeliver emails in the test
environment. You can see this under the swiftmailer
configuration option:
- YAML
- # config/packages/test/swiftmailer.yaml
- # ...
- swiftmailer:
- disable_delivery: true
- XML
- <!-- config/packages/test/swiftmailer.xml -->
- <?xml version="1.0" encoding="UTF-8" ?>
- <container xmlns="http://symfony.com/schema/dic/services"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
- xsi:schemaLocation="http://symfony.com/schema/dic/services
- https://symfony.com/schema/dic/services/services-1.0.xsd
- http://symfony.com/schema/dic/swiftmailer
- https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
- <!-- ... -->
- <swiftmailer:config disable-delivery="true"/>
- </container>
- PHP
- // config/packages/test/swiftmailer.php
- // ...
- $container->loadFromExtension('swiftmailer', [
- 'disable_delivery' => true,
- ]);
You can also use a different environment entirely, or override the defaultdebug mode (true
) by passing each as options to the createClient()
method:
- $client = static::createClient([
- 'environment' => 'my_test_env',
- 'debug' => false,
- ]);
Customizing Database URL / Environment Variables
If you need to customize some environment variables for your tests (e.g. theDATABASE_URL
used by Doctrine), you can do that by overriding anything youneed in your .env.test
file:
- # .env.test
- DATABASE_URL="mysql://db_user:[email protected]:3306/db_name_test"
- # use SQLITE
- # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"
This file is automatically read in the test
environment: any keys here overridethe defaults in .env
.
Caution
Applications created before November 2018 had a slightly different system,involving a .env.dist
file. For information about upgrading, see:Nov 2018 Changes to .env & How to Update.
Sending Custom Headers
If your application behaves according to some HTTP headers, pass them as thesecond argument of createClient()
:
- $client = static::createClient([], [
- 'HTTP_HOST' => 'en.example.com',
- 'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
- ]);
You can also override HTTP headers on a per request basis:
- $client->request('GET', '/', [], [], [
- 'HTTP_HOST' => 'en.example.com',
- 'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
- ]);
Tip
The test client is available as a service in the container in the test
environment (or wherever the framework.testoption is enabled). This means you can override the service entirelyif you need to.
PHPUnit Configuration
Each application has its own PHPUnit configuration, stored in thephpunit.xml.dist
file. You can edit this file to change the defaults orcreate a phpunit.xml
file to set up a configuration for your local machineonly.
Tip
Store the phpunit.xml.dist
file in your code repository and ignorethe phpunit.xml
file.
By default, only the tests stored in tests/
are run via the phpunit
command,as configured in the phpunit.xml.dist
file:
- <!-- phpunit.xml.dist -->
- <phpunit>
- <!-- ... -->
- <testsuites>
- <testsuite name="Project Test Suite">
- <directory>tests</directory>
- </testsuite>
- </testsuites>
- <!-- ... -->
- </phpunit>
But you can add more directories. For instance, the followingconfiguration adds tests from a custom lib/tests
directory:
- <!-- phpunit.xml.dist -->
- <phpunit>
- <!-- ... -->
- <testsuites>
- <testsuite name="Project Test Suite">
- <!-- ... --->
- <directory>lib/tests</directory>
- </testsuite>
- </testsuites>
- <!-- ... -->
- </phpunit>
To include other directories in the code coverage, also edit the <filter>
section:
- <!-- phpunit.xml.dist -->
- <phpunit>
- <!-- ... -->
- <filter>
- <whitelist>
- <!-- ... -->
- <directory>lib</directory>
- <exclude>
- <!-- ... -->
- <directory>lib/tests</directory>
- </exclude>
- </whitelist>
- </filter>
- <!-- ... -->
- </phpunit>
Learn more
- How to Customize the Bootstrap Process before Running Tests
- How to Test Code that Interacts with the Database
- Functional Test specific Assertions
- How to Simulate HTTP Authentication in a Functional Test
- How to Test the Interaction of several Clients
- How to Use the Profiler in a Functional Test
- The DomCrawler Component
- The CssSelector Component