Spec-Zone.ru › CakePHP 3.8

Класс TransportFactory

Класс-фабрика для создания экземпляров транспорта электронной почты.

Cake\Mailer\TransportFactory использует Cake\Core\StaticConfigTrait
Пространство имён: Cake\Mailer
Расположение: Mailer/TransportFactory.php

Краткое описание свойств

  • $_dsnClassMap protected static
    array
    Массив, сопоставляющий схемы URL с полными именами классов транспорта
  • $_registry protected static
    Cake\Mailer\TransportRegistry
    Регистр транспорта, используемый для создания и использования экземпляров транспорта.

Унаследованные свойства

  • _config

Краткое описание методов

  • _buildTransport() protected static
    Находит и создаёт экземпляр требуемого класса транспорта.
  • get() public static
    Получить экземпляр транспорта.
  • getRegistry() public static
    Возвращает регистр транспорта, используемый для создания и использования экземпляров транспорта.
  • setRegistry() public static
    Устанавливает экземпляр регистра транспорта, используемый для создания и использования экземпляров транспорта.

Подробное описание методов

_buildTransport()source protected static

_buildTransport( string $name )

Находит и создаёт экземпляр требуемого класса транспорта.

Параметры

строка $name
Имя массива конфигурации, для которого требуется создать экземпляр транспорта

Исключения

InvalidArgumentException
Когда транспорт не может быть создан.

get()source public static

get( string $name )

Получить экземпляр транспорта.

Параметры

строка $name
Имя конфигурации.

Возвращает

Cake\Mailer\AbstractTransport

getRegistry()source public static

getRegistry( )

Возвращает регистр транспорта, используемый для создания и использования экземпляров транспорта.

Возвращает

Cake\Mailer\TransportRegistry

setRegistry()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
Массив имени => данных конфигурации для адаптера.

Возвращает

массив|null
Null при добавлении конфигурации или массив данных конфигурации при чтении.

Исключения

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
Если не передана строка или передана некорректная строка
END_OF_DOCUMENT_MARKER

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API