Spec-Zone.ru › CakePHP 3.2

Трейт StaticConfigTrait

Трейт, предоставляющий набор статических методов для управления конфигурацией классов, предоставляющих фасад адаптера или которым требуется регистрация и манипулирование наборами данных конфигурации.

Ожидается, что реализующие объекты объявят статическое свойство $_dsnClassMap.

Прямые пользователи

  • Cake\Cache\Cache
  • Cake\Datasource\ConnectionManager
  • Cake\Log\Log
  • Cake\Mailer\Email
Пространство имён: Cake\Core
Расположение: Core/StaticConfigTrait.php

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

  • $_config protected static
    array
    Наборы конфигурации.

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

  • config() public static

    Этот метод может использоваться для определения адаптеров конфигурации для приложения или чтения существующей конфигурации.

  • configured() public static
    Возвращает массив, содержащий именованные конфигурации
  • drop() public static
    Удаляет сконструированный адаптер.
  • dsnClassMap() public static
    Возвращает или обновляет карту классов DSN для данного класса
  • parseDsn() public static
    Разбирает DSN в корректную конфигурацию подключения

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

config()source public static

config( string|array $key , array|null $config null )

Этот метод может использоваться для определения адаптеров конфигурации для приложения или чтения существующей конфигурации.

Чтобы изменить конфигурацию адаптера во время выполнения, сначала удалите адаптер, а затем переконфигурируйте его.

Адаптеры будут созданы только после первого выполнения операции.

Использование

Предполагая, что имя класса — Cache, поддерживаются следующие сценарии:

Чтение данных конфигурации:

Cache::config('default');

Настройка движка кеша:

Cache::config('default', $settings);

Вставка сконструированного адаптера:

Cache::config('default', $instance);

Конфигурация нескольких адаптеров одновременно:

Cache::config($arrayOfConfig);

Параметры

строка|массив $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

dsnClassMap( array $map null )

Возвращает или обновляет карту классов DSN для данного класса

Параметры

массив $map необязательно null
Добавления/изменения в карте классов для применения

Возвращаемое значение

массив

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

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

$_configsource

protected static массив

Наборы конфигурации.

[]

© 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.Core.StaticConfigTrait.html

Spec-Zone.ru

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