Tea example

This TYPO3 extension is an example for writing unit and functional tests for extbase/fluid-based extensions for TYPO3 CMS using PHPUnit.

It also is an example for best practices for extbase/fluid.

For information on the different ways to execute the tests, please have a look at the handout to my workshops on test-driven development (TDD).

Running the tests in PhpStorm

General PHPUnit setup

composer require typo3/cms ^8.7
composer install
git checkout HEAD -- composer.json

File > Settings > Languages & Frameworks > PHP > Test Frameworks

• (*) Use Composer autoloader
• Path to script: select vendor/autoload.php in your project folder

In the Run configurations, edit the PHPUnit configuration and use these settings so this configuration can serve as a template:

• Directory: use the Tests/Unit directory in your project
• Use alternative configuration file
• use .Build/vendor/nimut/testing-framework/res/Configuration/UnitTests.xml in your project folder
• Add the following environment variables:
  • typo3DatabaseUsername
  • typo3DatabasePassword
  • typo3DatabaseHost
  • typo3DatabaseName

Unit tests configuration

In the Run configurations, copy the PHPUnit configuration and use these settings:

• Directory: use the Tests/Unit directory in your project

Functional tests configuration

In the Run configurations, copy the PHPUnit configuration and use these settings:

• Directory: use the Tests/Functional directory in your project
• Use alternative configuration file
• use .Build/vendor/nimut/testing-framework/res/Configuration/FunctionalTests.xml

Example PHPUnit configuration file with a test suite

The file Configuration/PHPUnit/ModelTests.xml contains an example of a PHPUnit configuration file that has a test suite (based on the unit tests configuration file from the testing framework).

Creating new extensions with automated tests

For creating new extensions, I recommend taking Helmut Hummel's extension skeleton as a starting point.

About me (Oliver Klee)

I am the maintainer of the PHPUnit TYPO3 extension, which is available in the TYPO3 extension repository (TER).

You can book me for workshops at your company.

I also frequently give workshops at the TYPO3 Developer Days.

More Documentation

• Handout to my workshops on test-driven development (TDD)
• Handout for best practices with extbase and fluid

Other example projects

• Selenium demo for using Selenium with PHPUnit
• Anagram finder is the finished result of a code kata for TDD
• Coffee example is my starting point for demonstrating TDD with TYPO3 CMS
• TDD Seed for starting PHPUnit projects with Composer (without TYPO3 CMS)