Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robotusers/cakephp-table-inheritance
Single Table Inheritance implementation for CakePHP 3 ORM
https://github.com/robotusers/cakephp-table-inheritance
Last synced: about 1 month ago
JSON representation
Single Table Inheritance implementation for CakePHP 3 ORM
- Host: GitHub
- URL: https://github.com/robotusers/cakephp-table-inheritance
- Owner: robotusers
- License: mit
- Created: 2015-08-06T06:32:12.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-03-22T09:05:29.000Z (9 months ago)
- Last Synced: 2024-09-16T19:10:05.782Z (3 months ago)
- Language: PHP
- Homepage:
- Size: 52.7 KB
- Stars: 5
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cakephp - Robotusers/TableInheritance plugin - Singe Table Inheritance (STI) plugin. (ORM / Database / Datamapping)
README
# CakePHP Table Inheritance plugin
[](https://packagist.org/packages/robotusers/cakephp-table-inheritance)
[](https://packagist.org/packages/robotusers/cakephp-table-inheritance)
[](LICENSE)
[](https://travis-ci.org/robotusers/cakephp-table-inheritance)
[](https://codecov.io/gh/robotusers/cakephp-table-inheritance/branch/master)
This plugin implements [Single Table Inheritance](https://en.wikipedia.org/wiki/Single_Table_Inheritance) (and hopefully will implement Class Table Inheritance in the future) patterns for CakePHP ORM.
## Installation
CakePHP 4.x
Using composer:
```
composer require robotusers/cakephp-table-inheritance
```
For CakePHP 3.x use version 0.4 of the plugin
```
composer require robotusers/cakephp-table-inheritance:^0.4
```
## StiBehavior
For now only STI is supported. Just add a behavior to your tables:
```php
//in ClientsTable:
public function initialize(array $config)
{
$this->addBehavior('Robotusers/TableInheritance.Sti', [
'table' => 'users',
'discriminator' => 'client'
]);
}
//alternative config in AdministratorsTable:
public function initialize(array $config)
{
$this->table('users');
$this->addBehavior('Robotusers/TableInheritance.Sti');
$this->setDiscriminator('admin');
}
```
Now both the `ClientsTable` and `AdministratorsTable` will share `users` db table. A table has to have a `discriminator` field which will be used to determine which model's record is stored in a row.
### Multiple discriminators ###
You can also configure a list of allowed discriminators. It's useful for example when working with the files.
For example:
```php
//in ImagesTable:
public function initialize(array $config)
{
$this->addBehavior('Robotusers/TableInheritance.Sti', [
'table' => 'files',
'discriminatorField' => 'mime',
'acceptedDiscriminators' => [
'image/jpeg',
'image/gif',
'image/png',
'image/tiff'
]
]);
}
//or using wildcards:
public function initialize(array $config)
{
$this->addBehavior('Robotusers/TableInheritance.Sti', [
'table' => 'files',
'discriminatorField' => 'mime',
'acceptedDiscriminators' => [
'image/*'
]
]);
}
```
An `ImagesTable` will share `files` db table and match only specified mime types.
You can also add accepted discriminators on runtime:
```php
$table->addAcceptedDiscriminator('image/bmp');
```
### Configuration ###
`StiBehavior` supports following options:
* `discriminatorField` - db table field used to discriminate models, 'discriminator' by default
* `discriminator` - default discriminator value, `$table->alias()` by default
* `table` - db table to share, use this option or `$table->table()` method.
* `checkRules` - `true` by default. Allows to enable/disable build-in rule check for a discriminator value.
* `acceptedDiscriminators` - a list of accepted discriminators.
## StiParentBehavior
This plugin also allows to configure parent Table in order to create and hydrate entities based on child tables.
```php
//in UsersTable:
public function initialize(array $config)
{
$this->addBehavior('Robotusers/TableInheritance.StiParent', [
'tableMap' => [
'Administrators' => [
'admin',
'administrator'
],
'Clients' => 'client'
]
]);
}
```
`tableMap` option accepts an array mapping table registry aliases to discriminator field values.
You can also map discriminator values to specified table objects using `discriminatorMap` option:
```php
//in UsersTable:
public function initialize(array $config)
{
$this->addBehavior('Robotusers/TableInheritance.StiParent', [
'discriminatorMap' => [
'admin' => $this->tableLocator()->get('Administrators'),
'client' => $this->tableLocator()->get('Clients')
]
]);
}
```
This behavior also provides `newStiEntity()` method which will proxy `newEntity()` to one of the configured tables based on a discriminator value.
```php
$data = [
'name' => 'super-admin',
'discriminator' => 'admin'
];
$admin = $this->Users->newStiEntity($data); //will call AdministratorsTable::newEntity() and return an Administrator entity instance.
```
Afterwards you can get a STI table using `stiTable()` method and handle entity using its source `Table` object.
```php
$table = $this->Users->stiTable($admin);
$table->save($admin); //it will save an entity using AdministratorsTable
```
You can also directly detect STI table from data array:
```php
$data = [
'name' => 'super-admin',
'discriminator' => 'admin'
];
$table = $this->Users->stiTable($data);
$admin = $table->newEntity($data);
$table->save($admin);
```