Spec-Zone.ru › CakePHP 3.8

Трейт 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
Пространство имён: Cake\Core
Расположение: Core/InstanceConfigTrait.php

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

  • $_config protected
    array
    Конфигурация времени выполнения
  • $_configInitialized protected
    boolean
    Была ли конфигурация уже настроена со значениями по умолчанию

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

  • _configDelete() protected
    Удаляет один ключ конфигурации.
  • _configRead() protected
    Читает ключ конфигурации.
  • _configWrite() protected
    Записывает ключ конфигурации.
  • config() public deprecated
    Получает/устанавливает конфигурацию.
  • 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
при попытке перезаписать существующую конфигурацию
END_OF_DOCUMENT_MARKER

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
При попытке установить недопустимый ключ.

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

$_configsource

protected array

Конфигурация во время выполнения

[]

$_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

Spec-Zone.ru

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