类 BaseLog

基础日志引擎类。

抽象
命名空间: Cake\Log\Engine

属性概述

$_config protected

array<string, mixed>

运行时配置
$_configInitialized protected

bool

配置属性是否已使用默认值进行配置
$_defaultConfig protected

array<string, mixed>

此类的默认配置
$formatter protected

Cake\Log\Formatter\AbstractFormatter

方法概述

__construct() public

__construct 方法
_configDelete() protected

删除单个配置键。
_configRead() protected

读取配置键。
_configWrite() protected

写入配置键。
alert() public

必须立即采取行动。
configShallow() public

将提供的配置与现有配置合并。与config()（对嵌套键进行递归合并）不同，此方法进行简单合并。
critical() public

严重情况。
debug() public

详细调试信息。
emergency() public

系统无法使用。
error() public

运行时错误，不需要立即采取行动，但通常应该记录和监控。
getConfig() public

返回配置。
getConfigOrFail() public

返回此特定键的配置。
info() public

有趣的事件。
interpolate() protected

用上下文值替换消息字符串中的占位符。
levels() public

获取此记录器感兴趣的级别。
log() abstract public

使用任意级别记录。
notice() public

正常但重要的事件。
scopes() public

获取此记录器感兴趣的范围。
setConfig() public

设置配置。
warning() public

不属于错误的异常情况。

方法详细说明

__construct() ¶ public

__construct(array<string, mixed> $config = [])

__construct 方法

参数

array<string, mixed> $config optional: 配置数组

_configDelete() ¶ protected

_configDelete(string $key): void

删除单个配置键。

参数

string $key: 要删除的键。

void

抛出

Cake\Core\Exception\CakeException
如果尝试覆盖现有配置

_configRead() ¶ protected

_configRead(string|null $key): mixed

读取配置键。

参数

string|null $key: 要读取的键。

mixed

_configWrite() ¶ protected

_configWrite(array<string, mixed>|string $key, mixed $value, string|bool $merge = false): void

写入配置键。

参数

array<string, mixed>|string $key: 要写入的键。
mixed $value: 要写入的值。
string|bool $merge optional: 设置为 true 以递归合并，设置为 'shallow' 以简单合并，设置为 false 以覆盖，默认为 false。

void

抛出

Cake\Core\Exception\CakeException
如果尝试覆盖现有配置

alert() ¶ public

alert(stringStringable $message, mixed[] $context = []): void

必须立即采取行动。

例如：整个网站停机、数据库不可用等。这应该触发短信警报并唤醒你。

参数

stringStringable $message
mixed[] $context optional

void

configShallow() ¶ public

configShallow(array<string, mixed>|string $key, mixed|null $value = null): $this

将提供的配置与现有配置合并。与config()（对嵌套键进行递归合并）不同，此方法进行简单合并。

设置特定值

$this->configShallow('key', $value);

设置嵌套值

$this->configShallow('some.nested.key', $value);

同时更新多个配置设置

$this->configShallow(['one' => 'value', 'another' => 'value']);

参数

array<string, mixed>|string $key: 要设置的键，或完整的配置数组。
mixed|null $value optional: 要设置的值。

$this

critical() ¶ public

critical(stringStringable $message, mixed[] $context = []): void

严重情况。

例如：应用程序组件不可用、意外异常。

参数

stringStringable $message
mixed[] $context optional

void

debug() ¶ public

debug(stringStringable $message, mixed[] $context = []): void

详细调试信息。

参数

stringStringable $message
mixed[] $context optional

void

emergency() ¶ public

emergency(stringStringable $message, mixed[] $context = []): void

系统无法使用。

参数

stringStringable $message
mixed[] $context optional

void

error() ¶ public

error(stringStringable $message, mixed[] $context = []): void

运行时错误，不需要立即采取行动，但通常应该记录和监控。

参数

stringStringable $message
mixed[] $context optional

void

getConfig() ¶ public

getConfig(string|null $key = null, mixed $default = null): mixed

返回配置。

用法

读取整个配置

$this->getConfig();

读取特定值

$this->getConfig('key');

读取嵌套值

$this->getConfig('some.nested.key');

使用默认值读取

$this->getConfig('some-key', 'default-value');

参数

string|null $key optional: 要获取的键，或整个配置的 null。
mixed $default optional: 键不存在时的返回值。

mixed

getConfigOrFail() ¶ public

getConfigOrFail(string $key): mixed

返回此特定键的配置。

此键的配置值必须存在，不能为 null。

参数

string $key: 要获取的键。

mixed

抛出

InvalidArgumentException

info() ¶ public

info(stringStringable $message, mixed[] $context = []): void

有趣的事件。

例如：用户登录、SQL 日志。

参数

stringStringable $message
mixed[] $context optional

void

interpolate() ¶ protected

interpolate(Stringable|string $message, array $context = []): string

用上下文值替换消息字符串中的占位符。

参数

Stringable|string $message: 格式化后的消息。
array $context optional: 占位符值的上下文。

string

levels() ¶ public

levels(): list<string>

获取此记录器感兴趣的级别。

list<string>

log() ¶ abstract public

log(mixed $level, stringStringable $message, mixed[] $context = []): void

使用任意级别记录。

参数

mixed $level
stringStringable $message
mixed[] $context optional

void

抛出

Psr\Log\InvalidArgumentException

notice() ¶ public

notice(stringStringable $message, mixed[] $context = []): void

正常但重要的事件。

参数

stringStringable $message
mixed[] $context optional

void

scopes() ¶ public

scopes(): list<string>|null

获取此记录器感兴趣的范围。

list<string>|null

setConfig() ¶ public

setConfig(array<string, mixed>|string $key, mixed|null $value = null, bool $merge = true): $this

设置配置。

用法

设置特定值

$this->setConfig('key', $value);

设置嵌套值

$this->setConfig('some.nested.key', $value);

同时更新多个配置设置

$this->setConfig(['one' => 'value', 'another' => 'value']);

参数

array<string, mixed>|string $key: 要设置的键，或完整的配置数组。
mixed|null $value optional: 要设置的值。
bool $merge optional: 是否递归合并或覆盖现有配置，默认为 true。

$this

抛出

Cake\Core\Exception\CakeException
当尝试设置无效的键时。

warning() ¶ public

warning(stringStringable $message, mixed[] $context = []): void

不属于错误的异常情况。

例如：使用过时的 API、API 使用不当、不良做法（不一定错误）。

参数

stringStringable $message
mixed[] $context optional

void

属性详细说明

`$_config` ¶ protected

运行时配置

类型

array<string, mixed>

`$_configInitialized` ¶ protected

配置属性是否已使用默认值进行配置

类型

bool

`$_defaultConfig` ¶ protected

此类的默认配置

类型

array<string, mixed>

`$formatter` ¶ 受保护的

类型

Cake\Log\Formatter\AbstractFormatter

命名空间

类 BaseLog

属性概述

方法概述

__construct() public

_configDelete() protected

_configRead() protected

_configWrite() protected

alert() public

configShallow() public

critical() public

debug() public

emergency() public

error() public

getConfig() public

getConfigOrFail() public

info() public

interpolate() protected

levels() public

log() abstract public

notice() public

scopes() public

setConfig() public

warning() public

方法详细说明

__construct() ¶ public

参数

_configDelete() ¶ protected

参数

返回

抛出

_configRead() ¶ protected

参数

返回

_configWrite() ¶ protected

参数

返回

抛出

alert() ¶ public

参数

返回

configShallow() ¶ public

参数

返回

critical() ¶ public

参数

返回

debug() ¶ public

参数

返回

emergency() ¶ public

参数

返回

error() ¶ public

参数

返回

getConfig() ¶ public

用法

参数

返回

getConfigOrFail() ¶ public

参数

返回

抛出

info() ¶ public

参数

返回

interpolate() ¶ protected

参数

返回

levels() ¶ public

返回

log() ¶ abstract public

参数

返回

抛出

notice() ¶ public

参数

返回

scopes() ¶ public

`$_config` ¶ protected

`$_configInitialized` ¶ protected

`$_defaultConfig` ¶ protected

`$formatter` ¶ 受保护的