On this page
Class TableLocator
Provides a default registry/factory for Table objects.
- Cake\ORM\Locator\TableLocator implements Cake\ORM\Locator\LocatorInterface
Properties summary
-
$_configprotectedConfiguration for aliases.array -
$_fallbackedprotectedarrayContains a list of Table objects that were created out of the built-in Table class. The list is indexed by table alias
-
$_instancesprotectedInstances that belong to the registry.array -
$_optionsprotectedContains a list of options that were passed to get() method.array
Method Summary
-
_create() protectedWrapper for creating table instances
-
_getClassName() protectedGets the table class name.
-
clear() publicClears the registry of configuration and instances.
-
config() public
Stores a list of options to be used when instantiating an object with a matching alias.
-
exists() publicCheck to see if an instance exists in the registry.
-
genericInstances() public
Returns the list of tables that were created by this registry that could not be instantiated from a specific subclass. This method is useful for debugging common mistakes when setting up associations or created new table classes.
-
get() publicGet a table instance from the registry.
-
remove() publicRemoves an instance from the registry.
-
set() publicSet an instance.
Method Detail
_create()source protected
_create( array $options )
Wrapper for creating table instances
Parameters
-
array
$options - The alias to check for.
Returns
Cake\ORM\Table_getClassName()source protected
_getClassName( string $alias , array $options [] )
Gets the table class name.
Parameters
-
string
$alias - The alias name you want to get.
-
array
$optionsoptional [] - Table options array.
Returns
stringclear()source public
clear( )
Clears the registry of configuration and instances.
Implementation of
Cake\ORM\Locator\LocatorInterface::clear()
config()source public
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.
The options that can be stored are those that are recognized by get() If second argument is omitted, it will return the current settings for $alias.
If no arguments are passed it will return the full configuration array for all aliases
Parameters
-
string|null
$aliasoptional null - Name of the alias
-
array|null
$optionsoptional null - list of options for the alias
Returns
arrayThe config data.
Throws
RuntimeExceptionWhen you attempt to configure an existing table instance.
Implementation of
Cake\ORM\Locator\LocatorInterface::config()
exists()source public
exists( string $alias )
Check to see if an instance exists in the registry.
Parameters
-
string
$alias - The alias to check for.
Returns
booleanImplementation of
Cake\ORM\Locator\LocatorInterface::exists()
genericInstances()source public
genericInstances( )
Returns the list of tables that were created by this registry that could not be instantiated from a specific subclass. This method is useful for debugging common mistakes when setting up associations or created new table classes.
Returns
arrayget()source public
get( string $alias , array $options [] )
Get a table instance from the registry.
Tables are only created once until the registry is flushed. This means that aliases must be unique across your application. This is important because table associations are resolved at runtime and cyclic references need to be handled correctly.
The options that can be passed are the same as in Cake\ORM\Table::__construct(), but the className key is also recognized.
Options
classNameDefine the specific class name to use. If undefined, CakePHP will generate the class name based on the alias. For example 'Users' would result inApp\Model\Table\UsersTablebeing used. If this class does not exist, then the defaultCake\ORM\Tableclass will be used. By setting theclassNameoption you can define the specific class to use. The className option supports plugin short class references Cake\Core\App::shortName().tableDefine the table name to use. If undefined, this option will default to the underscored version of the alias name.connectionInject the specific connection object to use. If this option andconnectionNameare undefined, The table class'defaultConnectionName()method will be invoked to fetch the connection name.connectionNameDefine the connection name to use. The named connection will be fetched from Cake\Datasource\ConnectionManager.
Note If your $alias uses plugin syntax only the name part will be used as key in the registry. This means that if two plugins, or a plugin and app provide the same alias, the registry will only store the first instance.
Parameters
-
string
$alias - The alias name you want to get.
-
array
$optionsoptional [] -
The options you want to build the table with. If a table has already been loaded the options will be ignored.
Returns
Cake\ORM\TableThrows
RuntimeExceptionWhen you try to configure an alias that already exists.
Implementation of
Cake\ORM\Locator\LocatorInterface::get()
remove()source public
remove( string $alias )
Removes an instance from the registry.
Parameters
-
string
$alias - The alias to remove.
Implementation of
Cake\ORM\Locator\LocatorInterface::remove()
set()source public
set( string $alias , Cake\ORM\Table $object )
Set an instance.
Parameters
-
string
$alias - The alias to set.
Cake\ORM\Table$object- The table to set.
Returns
Cake\ORM\TableImplementation of
Cake\ORM\Locator\LocatorInterface::set()
Properties detail
$_fallbackedsource
protected array
Contains a list of Table objects that were created out of the built-in Table class. The list is indexed by table alias
[]
© 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.2/class-Cake.ORM.Locator.TableLocator.html