Class TransportFactory
Factory class for generating email transport instances.
- Cake\Mailer\TransportFactory uses Cake\Core\StaticConfigTrait
Properties summary
-
$_dsnClassMapprotected staticarrayAn array mapping url schemes to fully qualified Transport class names -
$_registryprotected staticTransport Registry used for creating and using transport instances.
Inherited Properties
Method Summary
-
_buildTransport() protected static
Finds and builds the instance of the required tranport class. -
get() public static
Get transport instance. -
getRegistry() public static
Returns the Transport Registry used for creating and using transport instances. -
setRegistry() public static
Sets the Transport Registry instance used for creating and using transport instances.
Method Detail
_buildTransport() protected static ¶
_buildTransport( string $name )
Finds and builds the instance of the required tranport class.
Parameters
- string $name
- Name of the config array that needs a tranport instance built
Throws
When a tranport cannot be created.
getRegistry() public static ¶
getRegistry( )
Returns the Transport Registry used for creating and using transport instances.
Returns
setRegistry() public static ¶
setRegistry( Cake\Mailer\TransportRegistry $registry )
Sets 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.
Methods used from Cake\Core\StaticConfigTrait
config() public static ¶
config( string|array $key , array|null $config null )
This 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);
Deprecated
Parameters
- string|array $key
- The name of the configuration, or an array of multiple configs.
- array|null $config optional null
- An array of name => configuration data for adapter.
Returns
Null when adding configuration or an array of configuration data when reading.
Throws
When trying to modify an existing config.
configured() public static ¶
configured( )
Returns an array containing the named configurations
Returns
Array of configurations.
drop() public static ¶
drop( string $config )
Drops 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
Success of the removal, returns false when the config does not exist.
dsnClassMap() public static ¶
dsnClassMap( array $map null )
Returns or updates the DSN class map for this class.
Deprecated
Parameters
- array $map optional null
- Additions/edits to the class map to apply.
Returns
getConfig() public static ¶
getConfig( string $key )
Reads existing configuration.
Parameters
- string $key
- The name of the configuration.
Returns
Array of configuration data.
getDsnClassMap() public static ¶
getDsnClassMap( )
Returns the DSN class map for this class.
Returns
parseDsn() public static ¶
parseDsn( string $dsn )
Parses 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
The configuration array to be stored after parsing the DSN
Throws
If not passed a string, or passed an invalid string
setConfig() public static ¶
setConfig( string|array $key , array $config null )
This 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 null
- An array of name => configuration data for adapter.
Throws
When trying to modify an existing config.
LogicException
When trying to store an invalid structured config array.
setDsnClassMap() public static ¶
setDsnClassMap( array $map )
Updates the DSN class map for this class.
Parameters
- array $map
- Additions/edits to the class map to apply.
Properties detail
$_dsnClassMap ¶
An array mapping url schemes to fully qualified Transport class names
[
'debug' => 'Cake\Mailer\Transport\DebugTransport',
'mail' => 'Cake\Mailer\Transport\MailTransport',
'smtp' => 'Cake\Mailer\Transport\SmtpTransport',
]