引言
系统内使用User表记录用户的属性,各自维护用户自身的关联数据。
有一些前端页面也会需要分别根据身份展示不同级别的内容。
本期为大家说一说给普通用户提权为 管理员。
数据准备
我们希望在users表内指定用户的身份,比如任命为管理员,则可以展示更多的数据资源。
我们在users表内追加一个字段 is_admin 用于标记用户的管理员身份,使用命令创建迁移文件:
php artisan make:migration add_is_admin_to_user_table --table=users
首先填充 up 方法用于迁移执行的逻辑:
public function up()
{
Schema::table('users', function(Blueprint $table)
{
$table->boolean('is_admin')->default(false);
});
}
如果迁移失败,进行回滚使用的 down 方法:
public function down()
{
Schema::table('users', function(Blueprint $table)
{
$table->dropColumn('is_admin');
}
}
完成编辑后保存,并执行迁移指令:
php artisan migrate
为了测试,我们使用mysql客户端直接连接数据库,并手动指定一个管理员,使用下面的SQL语句:
update users set is_admin = true where email = 'admin@admin.com';
路由
为了区别于普通用户的前端页面,我们使用新的命名空间 Admin 放置管理员相关的代码。首先创建控制器:
php artisan make:controller Admin/UsersController
然后添加路由,编辑 routes/web.php 文件并添加以下内容:
Route::group(['prefix' => 'admin', 'namespace' => 'Admin'], function()
{
Route::resource('user', 'UsersController');
});
注意我们使用了两个关键的参数,
- prefix : 也就是该组内的所有路由地址,使用 prefix 最为前缀
- namespace : 命名空间,指定该组内所有的控制器,均位于该命名空间下。
控制器
上一节的路由我们定义的是资源路由,使用restful风格声明。下面创建 app/Http/Controllers/admin/UsersController.php 文件,并实现 index 方法。代码内容如下:
public function index()
{
$users = User::orderBy('created_at', 'desc')->get();
return view('admin.users.index')->withUsers($users);
}
我们还需要一个视图文件,承载上述的数据。创建目录 resources/views/admin/users/index.blade.php,简单创建一个模板:
<h1>Registered Users</h1>
<ul>
@forelse ($users as $user)
<li>{{ $user->name }} ({{ $user->email }})</li>
@empty
<li>No registered users</li>
@endforelse
</ul>
展示的是所有用户的信息。这显然必须拥有较高的权限。所以我们在给数据之前,要识别用户是否管理员:
if (Auth::user()->is_admin != true) {
return redirect()->route('home')->withMessage('Access denied!');
}
如果不是就路由到首页。这样的判断,如果页面多了起来之后,每次都要在控制器内敲写,着实麻烦。所以,必须使用更靠前的验证,也就是 中间件!
中间件
中间件可以注册给路由文件,在命中路由后,调用中间件进行身份识别,这是不错的选择。
使用命令行创建中间件文件:
php artisan make:middleware AdminAuthentication
生成的文件位于 app/Http/Middleware/ 目录下,编辑 AdminAuthentication 文件,并实现代码逻辑:
namespace App\Http\Middleware;
use Closure;
use Illuminate\Contracts\Auth\Guard;
use Illuminate\Http\RedirectResponse;
class AdminAuthentication {
public function handle($request, Closure $next)
{
if ($request->user())
{
if ($request->user()->is_admin == true)
{
return $next($request);
}
}
// 验证不通过
return new RedirectResponse(url('/'));
}
}
然后在 app/Http/Kernel.php 文件内注册该中间件,并命名:
protected $routeMiddleware = [
'admin' => \App\Http\Middleware\AdminAuthentication::class,
];
修改 路由 一节中声明的路由组,引入中间件:
Route::group(
[
'prefix' => 'admin',
'namespace' => 'admin',
'middleware' => 'admin'
], function()
{
Route::resource('users', 'UsersController');
});
写在最后
本文又是一个功能齐全却又mini小巧的短文,详细阐述了如何为users表添加管理员功能。
通过注册路由到中间件的使用,又一次体验了laravel各个组件协同作用的能力!
Happy coding :-)
我是@程序员小助手,专注编程知识,圈子动态的IT领域原创作者