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.

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)

3.9 KiB Raw Blame History