Класс TransportFactory
Класс-фабрика для создания экземпляров транспорта электронной почты.
- Cake\Mailer\TransportFactory использует Cake\Core\StaticConfigTrait
Краткое описание свойств
- Массив, сопоставляющий схемы URL с полными именами классов транспорта
array - Регистр транспорта, используемый для создания и использования экземпляров транспорта.
Унаследованные свойства
Краткое описание методов
- Находит и создаёт экземпляр требуемого класса транспорта.
- Получить экземпляр транспорта.
- Возвращает регистр транспорта, используемый для создания и использования экземпляров транспорта.
- Устанавливает экземпляр регистра транспорта, используемый для создания и использования экземпляров транспорта.
Подробное описание методов
_buildTransport()source protected static
_buildTransport( string $name )
Находит и создаёт экземпляр требуемого класса транспорта.
Параметры
- строка
$name - Имя массива конфигурации, для которого требуется создать экземпляр транспорта
Исключения
InvalidArgumentExceptionКогда транспорт не может быть создан.
get()source public static
get( string $name )
Получить экземпляр транспорта.
Параметры
- строка
$name - Имя конфигурации.
Возвращает
Cake\Mailer\AbstractTransportgetRegistry()source public static
getRegistry( )
Возвращает регистр транспорта, используемый для создания и использования экземпляров транспорта.
Возвращает
Cake\Mailer\TransportRegistrysetRegistry()source public static
setRegistry( Cake\Mailer\TransportRegistry $registry )
Устанавливает экземпляр регистра транспорта, используемый для создания и использования экземпляров транспорта.
Также позволяет вводить новый экземпляр регистра.
Параметры
-
Cake\Mailer\TransportRegistry$registry - Объект вводимого регистра.
Используемые методы из Cake\Core\StaticConfigTrait
config()source public static deprecated
config( string|array $key , array|null $config = null )
Этот метод может быть использован для определения адаптеров конфигурации для приложения или чтения существующей конфигурации.
Чтобы изменить конфигурацию адаптера во время выполнения, сначала удалите адаптер, а затем переконфигурируйте его.
Адаптеры не будут созданы до тех пор, пока не будет выполнена первая операция.
Использование
Предполагая, что имя класса Cache поддерживаются следующие сценарии:
Чтение данных конфигурации обратно:
Cache::config('default'); Настройка движка кэша.
Cache::config('default', $settings); Ввод созданного адаптера:
Cache::config('default', $instance); Настройка нескольких адаптеров одновременно:
Cache::config($arrayOfConfig);
Устарело
3.4.0 Используйте setConfig()/getConfig() вместо этого.Параметры
- строка|массив
$key - Имя конфигурации или массив нескольких конфигураций.
- массив|null
$configнеобязательно null - Массив имени => данных конфигурации для адаптера.
Возвращает
массив|nullNull при добавлении конфигурации или массив данных конфигурации при чтении.
Исключения
BadMethodCallExceptionПри попытке изменить существующую конфигурацию.
configured()source public static
configured( )
Возвращает массив, содержащий указанные конфигурации
Возвращает
массив строкМассив конфигураций.
drop()source public static
drop( string $config )
Удаляет созданный адаптер.
Если вы хотите изменить существующую конфигурацию, вы должны удалить её, изменить конфигурацию, а затем добавить её снова.
Если реализующие объекты поддерживают объект $_registry указанная конфигурация также будет выгружена из реестра.
Параметры
- строка
$config - Существующая конфигурация, которую вы хотите удалить.
Возвращает
booleanУспешность удаления, возвращает false, когда конфигурация не существует.
dsnClassMap()source public static deprecated
dsnClassMap( array $map = null )
Возвращает или обновляет карту классов DSN для данного класса.
Устарело
3.4.0 Используйте setDsnClassMap()/getDsnClassMap() вместо этого.Параметры
- массив
$mapнеобязательно null - Добавления/изменения в карту классов для применения.
Возвращает
массивgetConfig()source public static
getConfig( string $key )
Читает существующую конфигурацию.
Параметры
- строка
$key - Имя конфигурации.
Возвращает
смешанныйДанные конфигурации по указанному ключу или null, если ключ не существует.
getDsnClassMap()source public static
getDsnClassMap( )
Возвращает карту классов DSN для данного класса.
Возвращает
массивparseDsn()source public static
parseDsn( string $dsn )
Парсит DSN в корректную конфигурацию соединения
Этот метод позволяет задать DSN, используя форматирование, подобное тому, которое используется PEAR::DB. Вот пример его использования:
$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);
Для всех классов значение scheme устанавливается как значение для className, если не указано иное.
Обратите внимание, что аргументы строки запроса также анализируются и устанавливаются в качестве значений в возвращаемой конфигурации.
Параметры
- строка
$dsn - Строка DSN для преобразования в массив конфигурации
Возвращает
массивМассив конфигурации для хранения после анализа DSN
Исключения
InvalidArgumentExceptionЕсли не передана строка или передана некорректная строка
setConfig()source public static
setConfig( string|array $key , array $config = null )
Этот метод можно использовать для определения конфигурационных адаптеров для приложения.
Чтобы изменить конфигурацию адаптера во время выполнения, сначала удалите адаптер, а затем переконфигурируйте его.
Адаптеры не будут созданы до тех пор, пока не будет выполнена первая операция.
Использование
Предполагая, что имя класса Cache, поддерживаются следующие сценарии:
Настройка движка кэша.
Cache::setConfig('default', $settings); Вставка созданного адаптера в:
Cache::setConfig('default', $instance); Настройка нескольких адаптеров сразу:
Cache::setConfig($arrayOfConfig);
Параметры
- строка|массив
$key - Имя конфигурации или массив нескольких конфигураций.
- массив
$configнеобязательно null - Массив данных конфигурации адаптера с именем в качестве ключа.
Исключения
BadMethodCallExceptionПри попытке изменить существующую конфигурацию.
LogicException
При попытке сохранить массив конфигурации с неверной структурой.
setDsnClassMap()source public static
setDsnClassMap( array $map )
Обновляет карту DSN-классов для данного класса.
Параметры
- массив
$map - Добавления/изменения в карту классов для применения.
Подробности свойств
$_dsnClassMapsource
protected static массив
Массив, сопоставляющий схемы URL с полными именами классов транспорта.
[
'debug' => 'Cake\Mailer\Transport\DebugTransport',
'mail' => 'Cake\Mailer\Transport\MailTransport',
'smtp' => 'Cake\Mailer\Transport\SmtpTransport',
] $_registrysource
protected static Cake\Mailer\TransportRegistry
Регистр транспортов, используемый для создания и использования экземпляров транспортов.
© 2005–present 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.
https://api.cakephp.org/3.8/class-Cake.Mailer.TransportFactory.html