使用 Laravel 快速构建网站系列 —— 内容管理系统：Laravel 5 Boilerplate

星期一, 2017-05-15 09:47 — adminshiping1

1、简介

Laravel 5 Boilerplate不是一个网站，也是一个建站工具，是基于当前Laravel最新版本（Laravel 5.1.*）并集成Boilerplate的项目。

2、GitHub

https://github.com/rappasoft/laravel-5-boilerplate

3、功能特性

自定义访问控制系统（认证/用户/角色/权限）
第三方登录（GitHub/Facebook/Twitter/Google）
通过邮箱验证用户
重新发送确认邮件
登录次数限制（登录失败情况下）
后台管理
- 用户列表
- 激活/冻结用户
- 软删除&永久删除用户
- 禁止用户
- 重新发送确认邮件
- 修改用户密码
- 创建/管理角色
- 创建/管理权限
- 创建/管理权限组
- 管理用户角色/权限
- 权限依赖
默认响应式布局
前后端控制器
用户面板
使用 Admin LTE主题的管理员面板
命名空间路由
自带Form/HTML门面
默认表单转化为表单帮助方法
通过通用组件管理布局文件
Laravel Elixir 3.0
使用Elixir编译CSS并自动将其置于HTML头部
使用Elixir编译JS并自动将其置于HTML尾部
帮助函数
JavaScript/jQuery片段
Bootstrap 3（LESS/SASS）
HTML5 Boilerplate v5.0
Font Awesome (LESS/SASS)
全局消息/异常处理
表单宏（状态和国家下拉框，可轻松扩展）
社会化登录认证集成
Laracast生成器
Stripe封装类
Active Menu
PHP转化为JavaScript
ARCANEDEV日志查看器
本地化，目前支持英语、意大利语、葡萄牙语（巴西）、俄语以及瑞典语等等
前后端语言选择菜单
头像
标准
- 干净的控制器
- Repository/Contract实现
- 请求类
- 事件/处理器
- 整个应用分割成前端/后端
- 处处本地化

4、安装

composer install
npm install
创建.env文件（示例中已包含）
php artisan key:generate
php artisan migrate
在UserTableSeeder.php设置管理员信息
php artisan db:seed
npm install -g gulp
运行gulp或gulp watch

5、访问控制系统

配置文件

/** Access使用Role模型创建正确的关联 */
access.role

/** Access使用的Roles表用于保存角色到数据库 */
access.roles_table

/** Access使用的Permission模型用于创建正确的关联 */
access.permission

/** Permissions table used by Access to save permissions to the database. */
access.permissions_table

/** Access使用的PermissionGroup模型用于创建权限组. */
access.group

/** Access使用的Permissions表用于保存权限到数据库 */
access.permissions_group_table

/** Access使用的permission_role表用于保存权限和角色之间的关系到数据库 */
access.permission_role_table

/** Access使用的permission_user表用于保存权限和用户之间的关系到数据库，该表仅用于那些只归属于特定用户而不是角色的权限 */
access.permission_user_table
/** 指定权限之间依赖关系的表，例如用户在拥有编辑权限之前必须有对后台的访问权限 */
access.permission_dependencies_table

/** Access使用的assigned_roles用于保存分配的角色到数据库 */
access.assigned_roles_table

/** 用户配置 */
access.users.default_per_page

/** 当用户在前台注册后分配的角色 */
access.users.default_role

/** 用户注册时是否需要邮箱确认 */
access.users.confirm_email

/** 用户邮箱是否可以在编辑用户信息页面被修改 */
access.users.change_email

/** 一个角色是否必须至少包含一个权限还是可以单独存在*/
access.roles.role_must_contain_permission

应用路由中间件

内置的路由中间件允许你通过角色或权限实现登录认证：

Route::group(['middleware' => 'access.routeNeedsPermission:view-backend', function()
{
     Route::group(['prefix' => 'access'], function ()
     {
         /* 用户管理 */
         Route::resource('users', 'Backend\Access\UserController');
     });
});

下面的中间件处理boilerplate：

access.routeNeedsRole
access.routeNeedsPermission

创建自己的中间件

如果你想要创建属于自己的中间件，可以使用如下方法：

/**
 * 通过名字判断用户是否拥有某个角色
 * @param string $name
 * @return bool
 */
Access::hasRole($role);

/**
 * 判断用户是否拥有某个角色数组，以及认证时是否全部包含才必须返回true
 * @param array $roles
 * @param boolean $needsAll
 * @return bool
 */
Access::hasRoles($roles, $needsAll);

/**
 * 通过名字判断用户是否拥有某个权限
 * 还有一个封装方法hasPermission这个传入参数一样
 * @param string $permission.
 * @return bool
 */
Access::can($permission);

/**
 * 判断权限数组以及是否所有权限都具备才能继续
 * 还有一个封装方法hasPermissions和此传入参数一样
 * @param array $permissions
 * @param boolean $needsAll
 * @return bool
 */
Access::canMultiple($permissions, $needsAll);

Access默认使用当前登录用户，你还可以：

$user->hasRole($role);
$user->hasRoles($roles, $needsAll);
$user->can($permission);
$user->canMultiple($permissions, $needsAll);
$user->hasPermission($permission); //Wrapper function for can()
$user->hasPermissions($permissions, $needsAll); //Wrapper function for canMultiple()

Blade扩展

可以定义一个blade扩展命令将访问控制应用到页面数据的显示与否：

@role

接收角色名称或ID

@role('User')
   只有认证用户有User角色才会显示这里的内容
@endauth

@role(1)
    只有认证用户有ID为1的角色才会显示这里的内容
@endauth

@roles

接收角色名称或ID数组

@roles(['Administrator', 'User'])
    只有认证用户拥有`Administrator`或`User`角色才会显示这里的内容
@endauth

@roles([1, 2])
    只有认证用户拥有ID为1或2的角色才会显示这里的内容
@endauth

@needsroles

接收角色或角色ID数组并且只有用户拥有提供的全部角色时才返回true

@needsroles(['Administrator', 'User'])
    只有认证用户拥有`Administrator`和`User`角色才会显示这里的内容
@endauth

@needsroles([1, 2])
    只有认证用户拥有ID为1和2的角色才会显示这里的内容
@endauth

@permission

接收单个权限名称或ID

@permission('view-backend')
    只有用户拥有`view-backend`权限时才会显示这里的内容
@endauth

@permission(1)
    只有用户拥有ID为1的权限时才会显示这里的内容
@endauth

@permissions

接收权限名称或ID数组

@permissions(['view-backend', 'view-some-content'])
    只有用户拥有`view-backend`或`view-some-content`权限时才会显示这里的内容
@endauth

@permissions([1, 2])
    只有用户拥有ID为1或2的权限时才会显示这里的内容
@endauth

@needspermissions

接收权限或权限ID数组并且用户拥有提供的全部权限时才返回true

@needspermissions(['view-backend', 'view-some-content'])
    只有用户拥有`view-backend`和`view-some-content`权限时才会显示这里的内容
@endauth

@needspermissions([1, 2])
    只有用户拥有ID为1和2的权限时才会显示这里的内容
@endauth

注意：你还可以使用@else用于if/else语句

如果你想要显示或隐藏特定区块，可以在布局文件中这样做：

@role('User')
    @section('special_content')
@endauth

@permission('can_view_this_content')
    @section('special_content')
@endauth

你还可以追加更多blade扩展命令到App\Providers\AccessServiceProvider@registerBladeExtensions。

6、权限依赖

权限依赖允许你告诉系统某个权限基于一个或多个其它权限。

例如：如果用户有创建用户权限，那么还要具备查看后台和查看访问管理的权限，否则他们不能到达创建用户界面。因此我们说创建用户权限依赖于查看后台和查看访问管理权限。

你可以在每个权限依赖设置中指定该权限依赖于哪些其他权限。

7、社交媒体

要配置社交媒体登录，添加你的凭证到.env文件。重定向必须遵循这个约定：http://mysite.com/auth/login/SERVICE。目前支持的社交媒体包括github, facebook, twitter, 和google，每一个的登录链接内置于login.blade.php。

如果你在本地locahost获取了cURL error 60错误，查看这些指导说明。

8、PHP转化为JavaScript

PHP->JavaScript转换器已经包含在本项目中，配置文件是config/javascript.php。

默认情况下JavaScript变量绑定到前端布局文件frontend/layouts/master.blade.php，因此你可以在任何前端控制器绑定任何JavaScript方法。

如果你需要在前端和后端控制器都绑定变量，应该创建一个全局总布局文件，并且使用前端/后端布局文件作为其子文件。再然后可以在javascript.bind_js_vars_to_this_view配置选项指定当前布局。

javascript()帮助函数已经添加到全局因此你不再需要在控制器中引入其它文件，只需要像这样调用该方法：

javascript()->put([
    'test' => 'it works!'
]);

这是一个FrontendController@index的示例，并且可以在frontend.index视图文件中打印出来。

9、可能出现的问题及解决办法

如果由于某种原因导致出错，试试下面的解决办法：

删除composer.lock文件

运行dumpautoload命令：

$ composer dumpautoload -o

如果上面的修复失败，并且命令行报错，错误信息指向compiled.php，则删除storage/framework/compiled.php文件。

如果上面的办法都没有奏效，那么只能给我们报告错误了。

学院君问下这个除了生成了一套权限使用上有什么便利么，还是需要自己make：controller 和make：model吗？

来自 http://laravelacademy.org/post/1359.html

普通分类:

laravel

You are here

1、简介

2、GitHub

3、功能特性

4、安装

5、访问控制系统

配置文件

应用路由中间件

创建自己的中间件

Blade扩展

6、权限依赖

7、社交媒体

8、PHP转化为JavaScript

9、可能出现的问题及解决办法

友情链接

搜索表单

用户登录

You are here

使用 Laravel 快速构建网站系列 —— 内容管理系统：Laravel 5 Boilerplate

1、简介

2、GitHub

3、功能特性

4、安装

5、访问控制系统

配置文件

应用路由中间件

创建自己的中间件

Blade扩展

6、权限依赖

7、社交媒体

8、PHP转化为JavaScript

9、可能出现的问题及解决办法

友情链接