AjaxChallenge

扩展 AbstractImmutableEvent 实现 ResultAwareInterface

onAjaxWebauthnChallenge 事件的具体事件类

4.2.0

Joomla CMS

方法

__construct

构造函数。

__construct( name, mixed||string|int arguments = []) : 
继承

4.0.0

抛出

BadMethodCallException

参数

name

string事件名称。

arguments

array<string|int, mixed>事件参数。

响应

mixed

addResult

将数据追加到事件的结果数组。

addResult( data) : 
继承

4.2.0

参数

data

mixed要添加到结果数组的内容。

响应

void

create

为给定事件名称和主题创建一个新的 CMS 事件对象。必须给出以下参数: 主题对象 事件的主题。这是您将要操作的核心对象。

create( eventName, mixed||string|int arguments = []) : 
继承 静态

eventClass string 事件类名。如果您未提供,将使用 Joomla\CMS\Events<eventNameWithoutOnPrefix>。

4.0.0

抛出

BadMethodCallException如果您未提供主题参数

参数

eventName

string事件名称,例如 onTableBeforeLoad

arguments

array<string|int, mixed>要传递给事件的附加参数

响应

静态

getArgument

获取事件参数值。

getArgument( name,  default = null) : 
继承

如果存在,它将使用预处理方法。该方法的签名为

onGet<ArgumentName>($value): mixed

其中

$value 是当前存储在事件 $arguments 数组中的值 它将返回要返回给调用者的值。

4.0.0

参数

name

string参数名称。

default

mixed如果未找到,则为默认值。

响应

mixed参数值或默认值。

getEventClassByEventName

获取给定事件名称的具体事件类名。

getEventClassByEventName( eventName) : 
继承 静态

如果此特性的事件名称未知,则此方法将回退到通用的 Joomla\Event\Event 类。

4.2.0

参数

eventName

string事件名称

响应

string事件类名

offsetSet

设置事件参数的值。

offsetSet( name,  value) : 
继承

4.0.0

抛出

BadMethodCallException

参数

name

string参数名称。

value

mixed参数值。

响应

void

offsetUnset

删除事件参数。

offsetUnset( name) : 
继承

4.0.0

抛出

BadMethodCallException

参数

name

string参数名称。

响应

void

onSetResult

处理直接设置结果参数。

onSetResult(mixed||string|int value) : mixed||string|int
继承

此方法具有双重目的:向后兼容性和强制使用 addResult。

当 $this->preventSetArgumentResult 为 false 时,它充当事件处理程序的向后兼容垫片,这些事件处理程序期望使用通用事件类而不是此包中实现的具体 Events。这允许在 Joomla 4.x 的整个生命周期内迁移到具体事件类。

当 $this->preventSetArgumentResult 为 false 时(在 Joomla 5.0 上始终如此),如果开发人员尝试调用 setArgument('result', ...) 而不是使用 addResult() 方法,它将抛出 BadMethodCallException。

4.4.0

参数

value

array<string|int, mixed>新的结果数组。

响应

array<string|int, mixed>

setArgument

向事件添加参数。

setArgument( name,  value) : 
继承

如果存在,它将使用预处理方法。该方法的签名为

onSet<ArgumentName>($value): mixed

其中

$value 是用户正在设置的值 它将返回要返回给事件 $arguments 数组的值。

4.0.0

参数

name

string参数名称。

value

mixed值。

响应

$this

setResult

处理直接设置结果参数。

setResult(mixed||string|int value) : mixed||string|int
继承 已弃用

此方法具有双重目的:向后兼容性和强制使用 addResult。

当 $this->preventSetArgumentResult 为 false 时,它充当事件处理程序的向后兼容垫片,这些事件处理程序期望使用通用事件类而不是此包中实现的具体 Events。这允许在 Joomla 4.x 的整个生命周期内迁移到具体事件类。

当 $this->preventSetArgumentResult 为 false 时(在 Joomla 5.0 上始终如此),如果开发人员尝试调用 setArgument('result', ...) 而不是使用 addResult() 方法,它将抛出 BadMethodCallException。

4.2.0

已弃用

4.4.0 将在 6.0 中删除 使用具有 onSet 前缀的对应方法

参数

value

array<string|int, mixed>新的结果数组。

响应

array<string|int, mixed>

typeCheckResult

确保结果是有效的 JSON 或布尔值 false

typeCheckResult( data) : 

4.2.0

参数

data

mixed要检查的数据

响应

void

属性

eventNameToConcreteClass

将事件名称映射到具体事件类。

继承 静态

这仅适用于事件名称不变的事件。具有可变名称的事件通过 getEventClassByEventName 类中的 PHP 逻辑进行处理。

4.2.0

类型

array<string|int, mixed>

constructed

一个标志,用于查看构造函数是否已被调用。

继承

4.0.0

类型

bool

preventSetArgumentResult

禁止使用 setArgument() 直接设置结果参数,而不是使用 addResult()。

继承 已弃用

您应仅对在 Joomla 4.2.0 之前不存在的事件名称设置此标志为 true,或者如果您是第三方开发者,并为仅在您的软件中使用的事件名称引入了新的事件名称。

4.2.0

已弃用

4.3 将在 6.0 中删除 使用 setResult() 设置结果参数将始终被禁止。

类型

bool