Class TransportFactory
Factory class for generating email transport instances.
Property Summary
-
$_config protected static
arrayConfiguration sets.
-
$_dsnClassMap protected static
arrayAn array mapping url schemes to fully qualified Transport class names
-
$_registry protected static
Cake\Mailer\TransportRegistryTransport Registry used for creating and using transport instances.
Method Summary
-
_buildTransport() protected static
Finds and builds the instance of the required tranport class.
-
config() public static deprecated
This method can be used to define configuration adapters for an application or read existing configuration.
-
configured() public static
Returns an array containing the named configurations
-
drop() public static
Drops a constructed adapter.
-
dsnClassMap() public static deprecated
Returns or updates the DSN class map for this class.
-
get() public static
Get transport instance.
-
getConfig() public static
Reads existing configuration.
-
getDsnClassMap() public static
Returns the DSN class map for this class.
-
getRegistry() public static
Returns the Transport Registry used for creating and using transport instances.
-
parseDsn() public static
Parses a DSN into a valid connection configuration
-
setConfig() public static
This method can be used to define configuration adapters for an application.
-
setDsnClassMap() public static
Updates the DSN class map for this class.
-
setRegistry() public static
Sets the Transport Registry instance used for creating and using transport instances.
Method Detail
_buildTransport() ¶ protected static
_buildTransport(string $name): voidFinds and builds the instance of the required tranport class.
Parameters
-
string$name Name of the config array that needs a tranport instance built
Returns
voidThrows
InvalidArgumentExceptionWhen a tranport cannot be created.
config() ¶ public static
config(string|array $key, array|null $config = null): array|nullThis method can be used to define configuration adapters for an application or read existing configuration.
To change an adapter's configuration at runtime, first drop the adapter and then reconfigure it.
Adapters will not be constructed until the first operation is done.
Usage
Assuming that the class' name is Cache the following scenarios
are supported:
Reading config data back:
Cache::config('default');Setting a cache engine up.
Cache::config('default', $settings);Injecting a constructed adapter in:
Cache::config('default', $instance);Configure multiple adapters at once:
Cache::config($arrayOfConfig);Parameters
-
string|array$key The name of the configuration, or an array of multiple configs.
-
array|null$config optional An array of name => configuration data for adapter.
Returns
array|nullThrows
BadMethodCallExceptionWhen trying to modify an existing config.
configured() ¶ public static
configured(): string[]Returns an array containing the named configurations
Returns
string[]drop() ¶ public static
drop(string $config): boolDrops a constructed adapter.
If you wish to modify an existing configuration, you should drop it, change configuration and then re-add it.
If the implementing objects supports a $_registry object the named configuration
will also be unloaded from the registry.
Parameters
-
string$config An existing configuration you wish to remove.
Returns
booldsnClassMap() ¶ public static
dsnClassMap(array|null $map = null): arrayReturns or updates the DSN class map for this class.
Parameters
-
array|null$map optional Additions/edits to the class map to apply.
Returns
arrayget() ¶ public static
get(string $name): Cake\Mailer\AbstractTransportGet transport instance.
Parameters
-
string$name Config name.
Returns
Cake\Mailer\AbstractTransportgetConfig() ¶ public static
getConfig(string $key): array|nullReads existing configuration.
Parameters
-
string$key The name of the configuration.
Returns
array|nullgetDsnClassMap() ¶ public static
getDsnClassMap(): arrayReturns the DSN class map for this class.
Returns
arraygetRegistry() ¶ public static
getRegistry(): Cake\Mailer\TransportRegistryReturns the Transport Registry used for creating and using transport instances.
Returns
Cake\Mailer\TransportRegistryparseDsn() ¶ public static
parseDsn(string $dsn): arrayParses a DSN into a valid connection configuration
This method allows setting a DSN using formatting similar to that used by PEAR::DB. The following is an example of its usage:
$dsn = 'mysql://user:pass@localhost/database?';
$config = ConnectionManager::parseDsn($dsn);
$dsn = 'Cake\Log\Engine\FileLog://?types=notice,info,debug&file=debug&path=LOGS';
$config = Log::parseDsn($dsn);
$dsn = 'smtp://user:secret@localhost:25?timeout=30&client=null&tls=null';
$config = Email::parseDsn($dsn);
$dsn = 'file:///?className=\My\Cache\Engine\FileEngine';
$config = Cache::parseDsn($dsn);
$dsn = 'File://?prefix=myapp_cake_core_&serialize=true&duration=+2 minutes&path=/tmp/persistent/';
$config = Cache::parseDsn($dsn);For all classes, the value of scheme is set as the value of both the className
unless they have been otherwise specified.
Note that querystring arguments are also parsed and set as values in the returned configuration.
Parameters
-
string$dsn The DSN string to convert to a configuration array
Returns
arrayThrows
InvalidArgumentExceptionIf not passed a string, or passed an invalid string
setConfig() ¶ public static
setConfig(string|array $key, array $config = null): voidThis method can be used to define configuration adapters for an application.
To change an adapter's configuration at runtime, first drop the adapter and then reconfigure it.
Adapters will not be constructed until the first operation is done.
Usage
Assuming that the class' name is Cache the following scenarios
are supported:
Setting a cache engine up.
Cache::setConfig('default', $settings);Injecting a constructed adapter in:
Cache::setConfig('default', $instance);Configure multiple adapters at once:
Cache::setConfig($arrayOfConfig);Parameters
-
string|array$key The name of the configuration, or an array of multiple configs.
-
array$config optional An array of name => configuration data for adapter.
Returns
voidThrows
BadMethodCallExceptionWhen trying to modify an existing config.
LogicExceptionWhen trying to store an invalid structured config array.
setDsnClassMap() ¶ public static
setDsnClassMap(array $map): voidUpdates the DSN class map for this class.
Parameters
-
array$map Additions/edits to the class map to apply.
Returns
voidsetRegistry() ¶ public static
setRegistry(Cake\Mailer\TransportRegistry $registry): voidSets the Transport Registry instance used for creating and using transport instances.
Also allows for injecting of a new registry instance.
Parameters
-
Cake\Mailer\TransportRegistry$registry Injectable registry object.
Returns
void