mirror of https://github.com/FriendsOfTYPO3/tea.git synced 2024-11-09 23:56:14 +01:00
Mirror of TYPO3 Extension tea, managed by the Best Practice Team https://typo3.org/community/teams/best-practices
Find a file
Oliver Klee adf0b308a1
[TASK] Update the dev dependencies (#36)
Also drop a redundant `--prefer-stable --prefer-dist` from the
installation process as this already is the configured default
in the `composer.json`.
2018-10-25 21:46:46 +02:00
Classes [FEATURE] Tea single view (#26) 2018-05-28 17:05:39 +02:00
Configuration [TASK] Drop the example PHPUnit configuration file (#29) 2018-05-31 16:09:06 +02:00
Resources [FEATURE] Tea single view (#26) 2018-05-28 17:05:39 +02:00
Tests [FEATURE] Example acceptance tests with Codeception (#31) 2018-05-31 23:48:38 +02:00
.gitignore [BUGFIX] Add .php_cs.cache to the .gitignore (#33) 2018-10-13 23:05:01 +02:00
.travis.yml [TASK] Update the dev dependencies (#36) 2018-10-25 21:46:46 +02:00
CHANGELOG.md [FEATURE] Auto-release to the TER (#34) 2018-10-13 23:23:27 +02:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2018-01-24 01:37:20 +01:00
codeception.yml [FEATURE] Example acceptance tests with Codeception (#31) 2018-05-31 23:48:38 +02:00
composer.json [TASK] Update the dev dependencies (#36) 2018-10-25 21:46:46 +02:00
ext_emconf.php [TASK] Add autoloading to ext_emconf.php 2018-01-12 23:28:58 +01:00
ext_icon.svg [FEATURE] Add extension icon 2017-12-23 01:15:25 +01:00
ext_localconf.php [FEATURE] Tea single view (#26) 2018-05-28 17:05:39 +02:00
ext_tables.sql [FEATURE] Add Tea.image as a FAL example (#15) 2018-05-25 22:39:33 +02:00
LICENSE Initial commit 2013-11-01 11:45:05 -07:00
README.md [BUGFIX] Make the Codeception instructions more robust 2018-06-01 10:58:34 +02:00

Tea example

Build Status Latest Stable Version Total Downloads Latest Unstable Version License

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 unit tests from the command line

.Build/bin/phpunit -c .Build/vendor/nimut/testing-framework/res/Configuration/UnitTests.xml Tests/Unit/

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 .Build/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

Running the acceptance tests

On the command line

  1. make sure you have Chrome installed on your machine
  2. composer update codeception/codeception (just in case)
  3. download the latest version of ChromeDriver
  4. unzip it
  5. chromedriver --url-base=wd/hub
  6. .Build/vendor/bin/codecept run (in another terminal)

In PhpStorm

  1. make sure the "Codeception Framework" plugin is activated
  2. right-click on Tests/Acceptance/StarterCest.php
  3. Run 'Acceptance (Codeception)'

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

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)