Sentinel：Laravel的Sentry实现

Sentinel 是一个针对Laravel框架的Sentry 2实现。默认情况下，它采用了Bootstrap 3.0，但你可以自由选择任何你喜欢的UI库。它的设计目的是让用户权限控制变得简单快速，对于简单的项目，你可能只需要将其安装并调整配置即可。

请注意，cartalyst/sentry认证包已废弃，如果你的项目中正在使用，应升级至cartalyst/sentinel。而本项目rydurham/sentinel也会在未来某个时间点被废弃，不建议用于新项目。如果你正在启动一个新的Laravel应用，我们推荐使用Srlabs/Centaur这一桥接包替代。

安装与配置

使用Composer安装最新版本：

composer require rydurham/sentinel

确保你的应用已经配置了数据库和邮件设置。Laravel 5及以上版本会自动通过"包发现"注册Sentinel的服务提供者。

添加中间件到app/Http/Kernel.php：

protected $routeMiddleware = [
    // ...
    'sentry.auth' => \Sentinel\Middleware\SentryAuth::class,
    'sentry.admin' => \Sentinel\Middleware\SentryAdminAccess::class,
    'sentry.member' => \Sentinel\Middleware\SentryMember::class,
    'sentry.guest' => \Sentinel\Middleware\SentryGuest::class,
];

发布视图、静态资源、配置文件和迁移：

php artisan sentinel:publish

你还可以指定主题选项发布特定主题的视图和静态资源：

php artisan sentinel:publish --theme="foundation"

运行数据库迁移：

php artisan migrate

并播种初始数据：

php artisan db:seed --class=SentinelDatabaseSeeder

最后，设定一个名为home的路由：

// routes/web.php
Route::get('/', function () {
    return view('welcome');
})->name('home');

使用

安装完成后，立即可以通过以下预定义的路由使用：

• yoursite.com/login
• yoursite.com/logout
• yoursite.com/register
• yoursite.com/users - 管理用户（仅限管理员）
• yoursite.com/groups - 管理组（仅限管理员）

Sentinel还提供了中间件来防止未经授权的访问。

扩展性

你可以关闭默认路由，并自定义符合应用程序逻辑的路由。创建继承自Sentinel默认User模型Sentinel\Models\User的新用户模型。记得在发布Sentinel和Sentry配置文件后，在Sentry的配置文件中更改用户模型的设置以指向你的新用户模型。

通过注入SentryUserRepository和/或SentryGroupRepository类到控制器中，可以直接操作用户和组。考虑创建自定义的仓库，这将扩展Sentinel提供的仓库。

不建议直接扩展Sentinel的控制器类，而是建议从头创建自己的控制器。

此外，Sentinel在测试环境中也有很好的支持，可以在测试用例中模拟用户登录状态。

文档与社区

更多关于配置选项、事件监听器、种子和迁移的详细信息，请查阅Wiki。有任何问题，可以访问项目网站进行提问。

Sentinel还支持多种语言，翻译工作在CrowdIn上进行，欢迎贡献和参与。

Sentinel为Laravel应用提供了强大且易用的身份验证解决方案，如果你正寻找一个快速启动用户管理功能的方法，那么它绝对值得一试。