Provides a registry/factory for Table objects.
This registry allows you to centralize the configuration for tables their connections and other meta-data.
You may need to configure your table objects, using TableRegistry you can centralize configuration. Any configuration set before instances are created will be used when creating instances. If you modify configuration after an instance is made, the instances will not be updated.
TableRegistry::config('Users', ['table' => 'my_users']);
Configuration data is stored per alias if you use the same table with multiple aliases you will need to set configuration multiple times.
You can fetch instances out of the registry using get(). One instance is stored per alias. Once an alias is populated the same instance will always be returned. This is used to make the ORM use less memory and help make cyclic references easier to solve.
$table = TableRegistry::get('Users', $config);
__callStatic( string $name , array $arguments )
Proxy for static calls on a locator.
$name
$arguments
mixed
config( string|null $alias null , array|null $options null )
Stores a list of options to be used when instantiating an object with a matching alias.
$alias
optional null $options
optional null array
exists( string $alias )
Check to see if an instance exists in the registry.
$alias
boolean
get( string $alias , array $options [] )
Get a table instance from the registry.
$alias
$options
optional [] Cake\ORM\Table
locator( Cake\ORM\Locator\LocatorInterface $locator null )
Sets and returns a singleton instance of LocatorInterface implementation.
Cake\ORM\Locator\LocatorInterface
$locator
optional null Cake\ORM\Locator\LocatorInterface
remove( string $alias )
Removes an instance from the registry.
$alias
set( string $alias , Cake\ORM\Table $object )
Set an instance.
$alias
Cake\ORM\Table
$object
Cake\ORM\Table
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/3.1/class-Cake.ORM.TableRegistry.html