Development environment

You can run the code quality checks and automated tests locally (using a local PHP, Composer, and database) or using runTests.sh.

To kickstart the project, we suggest the usage of the TYPO3-testing-distribution by Oliver Klee as development environment. The distribution comes with a frontend, example data and predefined plugins.

git clone git@github.com:oliverklee/TYPO3-testing-distribution.git

Also clone the tea extension.

git clone git@github.com:TYPO3BestPractices/tea.git

You can organize the folder structure as you wish, but lets say your folder structure looks like this:

git\
    TYPO3-testing-distribution
    tea

Inside the testing distribution there is a file docker-compose.extensions.yaml.template which mounts the used extensions. This file need to be renamed and adjusted.

cp .ddev/docker-compose.extensions.yaml.template .ddev/docker-compose.extensions.yaml

The file needs to mount the tea extension into the testing distribution. Keep in mind that you use the correct paths here.

services:
  web:
    volumes:
      - "$HOME/git/tea:/var/www/html/src/extensions/tea:cached,ro"

After that you can start the testing distribution using ddev.

ddev start
ddev composer install
ddev install-typo3
ddev db-import

After that you should be able to access the frontend:

ddev launch