Class yii\filters\AccessRule

应用此规则的操作 IDs 的数组列表。比较区分大小写。 如果未设置或为空，则表示此规则适用于所有操作。

无论这是 'allow' 规则还是 'deny' 规则。

应用此规则的控制器 IDs 的列表。

比较使用 yii\base\Controller::$uniqueId，因此每个控制器 ID 都带有前缀 使用模块 ID (如果有的话)。对于应用程序中的 product 控制器， 您可以指定此属性类似于 ['product'] 如果该控制器位于 shop 模块， 则将是 ['shop/product']。

比较区分大小写。

如果未设置或为空，则表示此规则适用于所有控制器。

自版本 2.0.12 起可以将控制器ID指定为通配符，例如 module/*。

在此规则确定应拒绝对 当前操作的访问时将调用的回调。当此规则匹配且 $allow 设置为 false 时就会出现这种情况。

如果未设置，则行为将由 yii\filters\AccessControl, 或者使用 yii\filters\AccessControl::denyAccess() 或 yii\filters\AccessControl::$denyCallback，如果已设置。

回调的签名应如下所示：

function ($rule, $action)

其中 $rule 是此规则，$action 是当前 action 对象。

参见 yii\filters\AccessControl::$denyCallback.

此规则应用于的用户 IP 地址列表。IP 地址 的末尾可以包含通配符* ，以便与前缀相同的 IP 地址相匹配。 例如，'192.168.*' 匹配网段 '192.168.' 中的所有 IP 地址。 如果未设置或为空，则表示此规则适用于所有 IP 地址。

参见 yii\web\Request::$userIP.

将被调用以确定是否应用规则的回调。 回调的签名应如下所示：

function ($rule, $action)

其中 $rule 是此规则，$action 是当前 action 对象。 回调应返回一个布尔值，指示是否应用此规则。

适用此规则的 RBAC （基于角色的访问控制）权限列表。 将调用 yii\web\User::can() 检查访问权限。

如果此属性未设置或为空，则表示无论权限如何此规则都适用。

参见：

• $roles
• $roleParams

传递给 yii\web\User::can() 函数的参数 用于评估 $roles 中的用户权限。

如果这是一个数组，它将直接传递给 yii\web\User::can()。例如 从当前请求传递 ID，您可以使用以下内容:

['postId' => Yii::$app->request->get('id')]

你还可以指定返回数组的闭包。只有在需要数组值的情况下， 才能使用该值来计算数组值, 例如当需要加载模型时 如下面的代码所示:

'rules' => [
    [
        'allow' => true,
        'actions' => ['update'],
        'roles' => ['updatePost'],
        'roleParams' => function($rule) {
            return ['post' => Post::findOne(Yii::$app->request->get('id'))];
        },
    ],
],

对 yii\filters\AccessRule 实例的引用将作为第一个参数传递给闭包。

参见 $roles.

此规则适用的角色列表（需要正确配置的用户组件）。 识别两个特殊角色，并通过 yii\web\User::$isGuest 检查它们：

• ?: 匹配来宾用户（尚未通过身份验证）
• @: 匹配经过身份验证的用户

如果使用 RBAC (Role-Based Access Control)，你还可以指定角色名称。 在这种情况下，将调用 yii\web\User::can() 检查访问权限。

请注意最好检查权限。

如果此属性未设置或为空，则表示无论角色如何，此规则都适用。

参见：

• $permissions
• $roleParams

此规则适用的请求方法（例如 GET, POST）的列表。 如果未设置或为空，这意味着此规则适用于所有请求方法。

参见 yii\web\Request::$method.