Spec-Zone.ru › CakePHP 3.6

Трейт 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 deprecated

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

  • configured() public static
    Возвращает массив, содержащий именованные конфигурации
  • drop() public static
    Удаляет созданный адаптер.
  • dsnClassMap() public static deprecated
    Возвращает или обновляет карту классов DSN для этого класса.
  • getConfig() public static
    Читает существующую конфигурацию.
  • getDsnClassMap() public static
    Возвращает карту классов DSN для этого класса.
  • parseDsn() public static
    Парсит DSN в корректную конфигурацию соединения
  • setConfig() public static
    Этот метод можно использовать для определения адаптеров конфигурации для приложения.
  • setDsnClassMap() public static
    Обновляет карту классов DSN для этого класса.

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

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() вместо этого.

Параметры

string|array $key
Имя конфигурации или массив нескольких конфигураций.
array|null $config optional null
Массив имя => конфигурационные данные для адаптера.

Возвращает

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

Выбрасывает

BadMethodCallException
При попытке изменить существующую конфигурацию.

configured()source public static

configured( )

Возвращает массив, содержащий именованные конфигурации

Возвращает

array
Массив конфигураций.

drop()source public static

drop( string $config )

Удаляет созданный адаптер.

Если вы хотите изменить существующую конфигурацию, необходимо удалить её, изменить конфигурацию, а затем повторно добавить её.

Если реализующие объекты поддерживают объект $_registry, именованная конфигурация также будет выгружена из реестра.

Параметры

string $config
Существующая конфигурация, которую нужно удалить.

Возвращает

boolean
Успех удаления, возвращает false, если конфигурации не существует.

dsnClassMap()source public static deprecated

dsnClassMap( array $map = null )

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

Устарело

3.4.0 Используйте setDsnClassMap()/getDsnClassMap() вместо этого.

Параметры

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

Возвращает

array

getConfig()source public static

getConfig( string $key )

Читает существующую конфигурацию.

Параметры

string $key
Имя конфигурации.

Возвращает

array|null
Массив конфигурационных данных.

getDsnClassMap()source public static

getDsnClassMap( )

Возвращает карту классов DSN для этого класса.

Возвращает

array

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, если они не были изменены.

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

Параметры

string $dsn
Строка DSN, которая должна быть преобразована в массив конфигурации

Возвращает

array
Массив конфигурации, который будет сохранен после разбора 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);

Параметры

string|array $key
Имя конфигурации или массив нескольких конфигураций.
array $config optional null
Массив имя => конфигурационные данные для адаптера.

Выбрасывает

BadMethodCallException
При попытке изменить существующую конфигурацию.
LogicException
При попытке сохранить некорректный массив конфигурации.

setDsnClassMap()source public static

setDsnClassMap( array $map )

Обновляет карту классов DSN для этого класса.

Параметры

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

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

$_configsource

protected static array

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

[]
END_OF_DOCUMENT_MARKER

© 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.6/class-Cake.Core.StaticConfigTrait.html

Spec-Zone.ru

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