Трейт StaticConfigTrait
Трейт, предоставляющий набор статических методов для управления конфигурацией для классов, предоставляющих фасад адаптера или нуждающихся в регистрации и манипулировании наборами данных конфигурации.
Ожидается, что реализующие объекты объявят статическое $_dsnClassMap свойство.
Прямые пользователи
Краткое описание свойств
- Наборы конфигурации.
array
Краткое описание методов
-
Этот метод можно использовать для определения адаптеров конфигурации для приложения или чтения существующей конфигурации.
- Возвращает массив, содержащий именованные конфигурации
- Удаляет созданный адаптер.
- Возвращает или обновляет карту классов DSN для этого класса.
- Читает существующую конфигурацию.
- Возвращает карту классов DSN для этого класса.
- Парсит DSN в корректную конфигурацию соединения
- Этот метод можно использовать для определения адаптеров конфигурации для приложения.
- Обновляет карту классов 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
$configoptional null - Массив имя => конфигурационные данные для адаптера.
Возвращает
array|nullNull при добавлении конфигурации или массив конфигурационных данных при чтении.
Выбрасывает
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
$mapoptional null - Добавления/изменения в карту классов для применения.
Возвращает
arraygetConfig()source public static
getConfig( string $key )
Читает существующую конфигурацию.
Параметры
- string
$key - Имя конфигурации.
Возвращает
array|nullМассив конфигурационных данных.
getDsnClassMap()source public static
getDsnClassMap( )
Возвращает карту классов DSN для этого класса.
Возвращает
arrayparseDsn()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
$configoptional null - Массив имя => конфигурационные данные для адаптера.
Выбрасывает
BadMethodCallExceptionПри попытке изменить существующую конфигурацию.
LogicException
При попытке сохранить некорректный массив конфигурации.
setDsnClassMap()source public static
setDsnClassMap( array $map )
Обновляет карту классов DSN для этого класса.
Параметры
- array
$map - Добавления/изменения в карту классов для применения.
Подробное описание свойств
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