# 用户和权限
<p class="uk-article-lead">Pagekit 自带一套注册程序和强大的用户管理器。对于系统中的所有用户，都可以在扩展中轻松地管理角色和权限。</p>
[toc=2]
## 概念
**用户/user**，即是在你网站上注册并以用户名来识别的人。用户账户的状态可以是 *激活/active*, *屏蔽/blocked* 或者 *新用户/new*。用户可以在网站或管理区域登录。并非所有用户的账号都允许访问管理区域。
**权限/Permissions** 定义用户可以执行的操作。权限由它的名称来区分，例如 `user: access admin area`。权限名称应当是描述性的，并以相关模块的名称开头，例如 `user:` 对于用户模块。
**角色/Roles** 将一些用户账号分组。所有相同角色的用户拥有相同的权限。角色还用于管理网站内容的访问。一个用户可以属于零个、一个或多个角色。一个角色也可以被指定任意数目的用户。Pagekit 默认设置了 **Anonymous**, **Authenticated** 和 **Administrator** 三种角色，也允许你创建更多角色。
## 只对特定角色显示内容
角色可以非常灵活地使用。你可以创建一些只有选中的用户才能访问的内容。.
1. 在 *Users > Roles* 创建新的角色 **Premium**。不要为它指定任何权限。
2. 在 *Users > List*中，点击一个用户账号编辑它的信息并为该用户启用**Premium**角色。
3. zai *Site*中的每个页面，你都可以在边栏中看到一个*Restrict access* 。确保只选择了它，不要选其他的。
该条目现在就只能被已登录的**Premium**角色的用户看到。
**Note** 你的管理员账号同样也不能看到这个内容，除非管理员账号也被设置为 **Premium** 角色，或者在 *Restrict access* 设置中启用了在**Administrator**。
## 从模块定义中注册权限
要为管理区域添加权限，并且可以将该权限指定给某个角色，在扩展的 `index.php` 文件中使用 `permissions` 关键字。
使用口语权限名。约定以扩展的名称开头，然后用简短的句子描述权限，都使用小写字母。`title` 是显示在浏览器中的字符串。`_()` 使该字符串是可以翻译的。
```php
'permissions' => [
'hello: manage settings' => [
'title' => _('Manage settings')
],
],
```
检查，该用户是否有一个指定 ID的角色。
```php
$role_id = 4;
App::user()->hasRole($role_id);
```
检查，该用户是否有一个指定名称的角色。
```php
$role_name = "Editor";
$role = Role::where('name = ?', [$role_name])->first();
App::user()->hasRole($role->id);
```
