Трейт 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Настройка свойства config уже настроена по умолчанию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 устаревшее
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Значение конфигурации, которое считывается.
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.7/class-Cake.Core.InstanceConfigTrait.html