Validate
扩展自 AbstractImmutableEvent 实现 ResultAwareInterface用于 onUserMultifactorValidate 事件的具体事件类
自 |
4.2.0 |
---|---|
包 |
Joomla CMS |
方法
__construct
公共构造函数
__construct(\Joomla\Component\Users\Administrator\Table\MfaTable record, \Joomla\CMS\User\User user, code) :
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 |
---|---|
抛出 |
|
参数
- 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 |
---|---|
抛出 |
|
参数
- name
string
参数名称。- value
mixed
参数值。
响应
void
offsetUnset
删除事件参数。
offsetUnset( name) :
自 |
4.0.0 |
---|---|
抛出 |
|
参数
- name
string
参数名称。
响应
void
onSetCode
验证名为“code”的参数的值
onSetCode(string|null value) : string|null
自 |
4.4.0 |
---|
参数
- value
string|null
要验证的值
响应
string|null
onSetRecord
验证名为“record”的参数的值
onSetRecord(\Joomla\Component\Users\Administrator\Table\MfaTable value) : \Joomla\Component\Users\Administrator\Table\MfaTable
自 |
4.4.0 |
---|
参数
- value
MfaTable
要验证的值
响应
MfaTable
onSetResult
处理直接设置 result 参数。
onSetResult(mixed||string|int value) : mixed||string|int
此方法具有双重目的:向后兼容性和强制使用 addResult。
当 $this->preventSetArgumentResult 为 false 时,它充当事件处理程序的向后兼容垫片,这些事件处理程序期望使用通用事件类而不是此包中实现的具体事件。这允许在 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>
onSetUser
验证名为“user”的参数的值
onSetUser(\Joomla\CMS\User\User value) : \Joomla\CMS\User\User
setArgument
将参数添加到事件。
setArgument( name, value) :
如果存在预处理方法,它将使用该方法。该方法的签名为
onSet<ArgumentName>($value): mixed
其中
$value 是用户设置的值它返回要返回到事件的 $arguments 数组中设置的值。
自 |
4.0.0 |
---|
参数
- name
string
参数名称。- value
mixed
值。
响应
$this
setCode
验证名为“code”的参数的值
setCode(string|null value) : string|null
自 |
4.2.0 |
---|---|
已弃用 |
4.4.0 将在 6.0 中删除 使用带有 onSet 前缀的对应项 |
参数
- value
string|null
要验证的值
响应
string|null
setRecord
验证名为“record”的参数的值
setRecord(\Joomla\Component\Users\Administrator\Table\MfaTable value) : \Joomla\Component\Users\Administrator\Table\MfaTable
自 |
4.2.0 |
---|---|
已弃用 |
4.4.0 将在 6.0 中删除 使用带有 onSet 前缀的对应项 |
参数
- value
MfaTable
要验证的值
响应
MfaTable
setResult
处理直接设置 result 参数。
setResult(mixed||string|int value) : mixed||string|int
此方法具有双重目的:向后兼容性和强制使用 addResult。
当 $this->preventSetArgumentResult 为 false 时,它充当事件处理程序的向后兼容垫片,这些事件处理程序期望使用通用事件类而不是此包中实现的具体事件。这允许在 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>
setUser
验证名为“user”的参数的值
setUser(\Joomla\CMS\User\User value) : \Joomla\CMS\User\User
属性
eventNameToConcreteClass
将事件名称映射到具体事件类。
这仅适用于事件名称不变的事件。具有可变名称的事件在 getEventClassByEventName 类中使用 PHP 逻辑处理。
自 |
4.2.0 |
---|
类型
array<string|int, mixed>
构造
一个标志,用于查看是否已调用构造函数。
自 |
4.0.0 |
---|
类型
bool
resultIsNullable
result 属性值也可以为 NULL 吗?
自 |
4.2.0 |
---|
类型
bool
preventSetArgumentResult
不允许使用 setArgument() 直接设置 result 参数,而应通过 addResult() 设置。
您应该仅对在 Joomla 4.2.0 之前不存在的事件名称或您是第三方开发人员为仅在您的软件中使用引入新事件名称时将其设置为 true。
自 |
4.2.0 |
---|---|
已弃用 |
4.3 将在 6.0 中删除。对于 result 参数,将始终不允许使用 setResult()。 |
类型
bool