contao-community-alliance/dc-general

Universal data container for Contao

2.3.24 2024-10-13 23:00 UTC

Requires

• php: ^8.1
• ext-json: *
• ext-pdo: *
• contao-community-alliance/events-contao-bindings: ^4.13
• contao-community-alliance/translator: ^2.4.2
• contao-community-alliance/url-builder: ^1.3
• contao/core-bundle: ^4.13
• contao/image: ^1.1
• doctrine/cache: ^1.13 || ^2.1
• doctrine/dbal: ^3.5
• knplabs/knp-menu: ^3.1
• psr/event-dispatcher: ^1.0
• symfony/cache: ^5.4
• symfony/cache-contracts: ^2.5.2
• symfony/config: ^5.4
• symfony/dependency-injection: ^5.4
• symfony/event-dispatcher: ^5.4
• symfony/event-dispatcher-contracts: ^2.0 || ^3.0
• symfony/expression-language: ^5.4
• symfony/http-foundation: ^5.4
• symfony/http-kernel: ^5.4
• symfony/polyfill-mbstring: ^1.0
• symfony/routing: ^5.4
• symfony/security-core: ^5.4
• symfony/security-csrf: ^5.4
• symfony/translation-contracts: ^2.5
• twig/twig: ^3.0

Requires (Dev)

• contao/manager-plugin: ^2.8
• friendsofsymfony/http-cache: ^2.9
• menatwork/contao-multicolumnwizard-bundle: ^3.4
• php-http/guzzle6-adapter: ^2.0
• phpcq/runner-bootstrap: ^1.0@dev

Conflicts

• menatwork/contao-multicolumnwizard-bundle: <3.4.9

LGPL-3.0-or-later

• Christian Schiffler
• Stefan Heimes

• container
• framework
• php
• data
• driver
• contao

README

DC_General

The DC_General is a universal data container for Contao and is an alternative for the DC_Table of the Contao framework.

With the DC_General we facilitate programming with excellent functions and influence possibilities.

Different to Contao DC_Table

With the use of the DC_General there are many advantages, e.g.

• Object-oriented data container definitions
• Event driven
• abstraction of the data source
• modular design
• verification of data - no invalid records
• improved configuration of dependencies between data containers
• more control through events

How to use

Simply declare an DCA as usual but put "General" instead of "Table" for the 'config/dataContainer' part. This will make DC_General to be used.

There are some notable changes in compatibility considering DC_Table:

1. DC_General does NOT support magic properties but provides setter and getter for almost anything you might desire.
2. There is NO activeRecord available as DC_General uses it's own kind of data Models internally.
3. The system is totally event driven and relevant information (like the model in scope) is attached to the events.

Help for the start

You can start with our new documentation (currently in german) or older one (in english).

We have an overview of DCA mapping and Callbacks.

In our examples you can see the difference to DC_Table.