codappix/typo3-php-datasets

Enables usage of PHP data sets within TYPO3.

v1.5.0 2024-02-05 14:51 UTC

Requires

• php: ^7.2 || ^7.3 || ^7.4 || ^8.0 || ^8.1 || ^8.2 || ^8.3
• composer-runtime-api: ^2.2
• doctrine/dbal: ^2.13 || ^3.6 || ^4.0 || 4.0.0-RC2
• symfony/console: ^5.4 || ^6.2 || ^7.0
• typo3/cms-core: ^10.4 || ^11.5 || ^12.4 || ^13.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.4
• phpstan/phpstan: ^1.10
• phpstan/phpstan-phpunit: ^1.3
• phpunit/phpunit: ^8.5 || ^9.6 || ^10.0
• typo3/testing-framework: ^6.16 || ^7.0 || ^8.0

GPL-2.0-or-later

• Daniel Siepmann

• testing
• dev

README

Provides APIs to use data sets written as PHP arrays with TYPO3.

Why

We don't like the approach of TYPO3 Testing Framework regarding DataSets.

We have the following issues:

1. XML is only supported for imports, not for assertions
2. CSV is a bad format that already got hacked, e.g. # to indicate comments. We consider it bad as one needs special toolings in order to properly write CSV files, they are not human readable.

That's why we prefer PHP files instead. That way developers are free to use whatever they want. Either plain PHP or even YAML or other formats. They are not forced to anything but can stick to their known tooling.

We also have situations where we wanna have static database records on production that are maintained by PHP data sets and update wizards.

So this package should in general handle PHP data sets for TYPO3. It should ease the abstract usage by providing convenient integrations for general use cases, like the testing framework.

Usage

See our own tests for how to use, as they do nothing else.

Within testing framework

1. Create data set

   A data set is a PHP file that returns an array of tables with their records. Format is:

   return [
       'table_name' => [
           // Records
           [
               // column_name => value
               'uid' => 1,
           ],
       ],
   ];

2. Import the Codappix\Typo3PhpDatasets\TestingFramework trait

   use Codappix\Typo3PhpDatasets\TestingFramework as PhpDatasets;
   
   final class MyTest extends FunctionalTestCase
   {
       use PhpDatasets;
   
       // ...
   }

3. Use API

   Import:

   $this->importPHPDataSet(__DIR__ . '/Fixtures/SimpleSet.php');

   Assert:

   $this->assertPHPDataSet(__DIR__ . '/Fixtures/SimpleSet.php');

Converter

The package provides a single bin with command to convert existing data-sets. The bin is available as typo3-php-datasets. Available commands:

• convert-from-xml
• convert-from-csv

Each command will convert the existing file(s) and place a new php variant next to it. Existing files are only read, not changed.

TODO

1. Implement use case to check for necessary updates and allow updates. Use for static data during deployment within update wizards or other scripts.