Трейт InstanceConfigTrait
Трейт для чтения и записи конфигурации экземпляра
Ожидается, что реализующие объекты объявят свойство $_defaultConfig.
Прямые пользователи
- Cake\Auth\AbstractPasswordHasher
- Cake\Auth\BaseAuthenticate
- Cake\Http\Client
- Cake\Log\Engine\BaseLog
- Cake\Mailer\AbstractTransport
- Cake\Network\Socket
- Cake\ORM\Behavior
- Cake\Routing\DispatcherFilter
- Cake\View\Helper
- Cake\View\StringTemplate
- Cake\Auth\BaseAuthorize
- Cake\Auth\Storage\SessionStorage
- Cake\Cache\CacheEngine
- Cake\Console\Helper
- Cake\Controller\Component
- Cake\Datasource\Paginator
- Cake\Error\Debugger
- Cake\Error\Middleware\ErrorHandlerMiddleware
Косвенные пользователи
- Cake\Auth\BasicAuthenticate
- Cake\Auth\ControllerAuthorize
- Cake\Cache\Engine\MemcachedEngine
- Cake\Cache\Engine\NullEngine
- Cake\Cache\Engine\RedisEngine
- Cake\Cache\Engine\WincacheEngine
- Cake\Cache\Engine\XcacheEngine
- Cake\Controller\Component\AuthComponent
- Cake\Controller\Component\CookieComponent
- Cake\Controller\Component\CsrfComponent
- Cake\Controller\Component\FlashComponent
- Cake\Controller\Component\PaginatorComponent
- Cake\Auth\DefaultPasswordHasher
- Cake\Controller\Component\RequestHandlerComponent
- Cake\Controller\Component\SecurityComponent
- Cake\Log\Engine\ConsoleLog
- Cake\Log\Engine\FileLog
- Cake\Log\Engine\SyslogLog
- Cake\Mailer\Transport\DebugTransport
- Cake\Mailer\Transport\MailTransport
- Cake\Mailer\Transport\SmtpTransport
- Cake\ORM\Behavior\CounterCacheBehavior
- Cake\ORM\Behavior\TimestampBehavior
- Cake\Auth\DigestAuthenticate
- Cake\ORM\Behavior\TranslateBehavior
- Cake\ORM\Behavior\TreeBehavior
- Cake\Routing\Filter\AssetFilter
- Cake\Routing\Filter\ControllerFactoryFilter
- Cake\Routing\Filter\LocaleSelectorFilter
- Cake\Routing\Filter\RoutingFilter
- Cake\Shell\Helper\ProgressHelper
- Cake\Shell\Helper\TableHelper
- Cake\TestSuite\TestEmailTransport
- Cake\View\Helper\BreadcrumbsHelper
- Cake\Auth\FallbackPasswordHasher
- Cake\View\Helper\FlashHelper
- Cake\View\Helper\FormHelper
- Cake\View\Helper\HtmlHelper
- Cake\View\Helper\NumberHelper
- Cake\View\Helper\PaginatorHelper
- Cake\View\Helper\RssHelper
- Cake\View\Helper\SessionHelper
- Cake\View\Helper\TextHelper
- Cake\View\Helper\TimeHelper
- Cake\View\Helper\UrlHelper
- Cake\Auth\FormAuthenticate
- Cake\Auth\WeakPasswordHasher
- Cake\Cache\Engine\ApcuEngine
- Cake\Cache\Engine\ArrayEngine
- Cake\Cache\Engine\FileEngine
Краткое описание свойств
-
$_configprotectedКонфигурация времени выполненияarray -
$_configInitializedprotectedБыла ли конфигурация уже настроена со значениями по умолчаниюboolean
Краткое описание методов
- _configDelete() protectedУдаляет один ключ конфигурации.
- _configRead() protectedЧитает ключ конфигурации.
- _configWrite() protectedЗаписывает ключ конфигурации.
- Получает/устанавливает конфигурацию.
- configShallow() public
Объединяет предоставленную конфигурацию с существующей. В отличие от
config(), которая выполняет рекурсивное объединение для вложенных ключей, этот метод выполняет простое объединение. - getConfig() publicВозвращает конфигурацию.
- setConfig() publicУстанавливает конфигурацию.
Подробное описание методов
_configDelete()source protected
_configDelete( string $key )
Удаляет один ключ конфигурации.
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписать существующую конфигурацию
_configRead()source protected
_configRead( string|null $key )
Читает ключ конфигурации.
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
смешанный_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge = false )
Записывает ключ конфигурации.
Параметры
- строка|массив
$key - Ключ для записи.
- смешанный
$value - Значение для записи.
- булево|строка
$mergeнеобязательно false Истина для рекурсивного объединения, 'shallow' для простого объединения, ложь для перезаписи, по умолчанию ложь.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписать существующую конфигурацию
config()source public deprecated
config( string|array|null $key = null , mixed|null $value = null , boolean $merge = true )
Получает/устанавливает конфигурацию.
Использование
Чтение всей конфигурации:
$this->config();
Чтение определённого значения:
$this->config('key'); Чтение вложенного значения:
$this->config('some.nested.key'); Установка определённого значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Устарело
3.4.0 используйте setConfig()/getConfig() вместо этого.Параметры
- string|array|null
$keyнеобязательно null - Ключ для получения/установки или массив всей конфигурации.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Флаг рекурсивного слияния или перезаписи существующей конфигурации, по умолчанию true.
Возвращает
mixedЗначение конфигурации для чтения, или сам объект при операциях записи.
Выбрасывает
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value = null )
Объединение предоставленной конфигурации с существующей. В отличие от config(), которое выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка определённого значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или полный массив конфигураций.
- mixed|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key = null , mixed $default = null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определённого значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- string|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultнеобязательно null - Возвращаемое значение, если ключ не существует.
Возвращает
mixedДанные конфигурации по указанному ключу или null, если ключ не найден.
setConfig()source public
setConfig( string|array $key , mixed|null $value = null , boolean $merge = true )
Устанавливает конфигурацию.
Использование
Установка определённого значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или полный массив конфигураций.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Флаг рекурсивного слияния или перезаписи существующей конфигурации, по умолчанию true.
Возвращает
$this
Выбрасывает
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробное описание свойств
$_configInitializedsource
protected boolean
Флаг, указывающий, была ли конфигурация уже настроена по умолчанию
false
© 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.Core.InstanceConfigTrait.html