README

Laravel: 5.0
作者: Ollie Read
作者主页: http://ollieread.com

此软件包不是laravels默认Auth库的替代品，而是一种介于您的代码和库之间的东西。

将其视为Auth的工厂类。现在，您不仅可以针对多个表/模型进行用户认证，而且与该软件包的前一个版本不同，您可以访问所有功能，甚至可以为每个用户类型使用不同的驱动程序。

除此之外，您还可以同时使用多种认证类型，这样您就可以作为用户、主账户和管理员登录，而不会发生冲突！

自定义认证驱动程序

在当前这个时间点，为基本Auth类编写的自定义Auth驱动程序将无法工作。我目前正在研究这个问题，但在此期间，您可以通过将您的闭包更改为返回Ollieread\Multiauth\Guard实例而不是默认实例来解决这个问题。

安装

首先，您想在composer.json文件中包含此软件包。

"require": {
		"ollieread/multiauth": "dev-master"
}

现在您将想要通过composer更新或安装。

composer update

接下来，您打开app/config/app.php并替换AuthServiceProvider。

"Ollieread\Multiauth\MultiauthServiceProvider"

注意非常重要，您必须替换默认的服务提供程序。如果您不希望使用提醒，则应删除原始的Reminder服务提供程序，因为它将导致错误。

配置也很简单，使用app/config/auth.php及其默认值。

return array(

	'driver' => 'eloquent',

	'model' => 'User',

	'table' => 'users',

	'reminder' => array(

		'email' => 'emails.auth.reminder',

		'table' => 'password_reminders',

		'expire' => 60,

	),

);

现在请删除前三个选项，并按以下方式替换。

return array(

	'multi'	=> array(
		'account' => array(
			'driver' => 'eloquent',
			'model'	=> 'Account'
		),
		'user' => array(
			'driver' => 'database',
			'table' => 'users'
		)
	),

	'reminder' => array(

		'email' => 'emails.auth.reminder',

		'table' => 'password_reminders',

		'expire' => 60,

	),
	
	 'globals' => [
	 
		'user',	'check'
		
	],


);

提醒

如果您想使用提醒，您需要在app/config/app.php文件中替换ReminderServiceProvider为以下内容。

Ollieread\Multiauth\Reminders\ReminderServiceProvider

要生成提醒表，您需要运行以下命令。

php artisan multiauth:reminders-table

同样，如果您想清除所有提醒，您必须运行以下命令。

php artisan multiauth:clear-reminders

由于reminders-controller命令不会与该软件包处理认证的方式一起工作，因此已被删除。我计划在未来解决这个问题。

该概念与默认Auth提醒相同，不同之处在于您以相同的方式访问一切，即在方法前加上认证类型。

如果您想为每个用户类型使用不同的视图，只需在配置中添加一个电子邮件选项，方式与auth.reminder内部相同。

要发送提醒，您将执行以下操作。

Password::account()->remind(Input::only('email'), function($message) {
	$message->subject('Password reminder');
});

要重置密码，您将执行以下操作。

Password::account()->reset($credentials, function($user, $password) {
	$user->password = Hash::make($password);
	$user->save();
});

为了简单地区分哪个令牌属于哪个用户（因为我们完全有可能有两个不同类型的用户，它们具有相同的令牌），我已修改我的提醒电子邮件以包含一个类型属性。

To reset your password, complete this form: {{ URL::to('password/reset', array($type, $token)) }}.

这会生成如下URL。

http://laravel.ollieread.com/password/reset/account/27eb8fe5fe666b3b8d0521156bbf53266dbca572

它匹配以下路由。

Route::any('/password/reset/{type}/{token}', 'Controller@method');

用法

一切都将与原始库完全相同，唯一的例外是所有方法调用都带有键（在上面的例子中是account或user）作为方法本身。

Auth::account()->attempt(array(
	'email'		=> $attributes['email'],
	'password'	=> $attributes['password'],
));
Auth::user()->attempt(array(
	'email'		=> $attributes['email'],
	'password'	=> $attributes['password'],
));
Auth::account()->check();
Auth::user()->check();

如果您需要以原始库的方式调用方法，例如获取任何类型的认证用户，只需在配置文件中的'globals'数组中添加方法名称，现在您可以直接使用如下所示

Auth::user();
Auth::check();

而不是

Auth::user()->user();
Auth::user()->check();

在您有可以模仿其他用户类型的用户类型的情况下，例如管理员模仿用户以重新创建或检查某些内容，我在请求用户类型上添加了一个简单的impersonate()方法，它只是封装了loginUsingId()方法。

Auth::admin()->impersonate('user', 1, true);

第一个参数是用户类型，第二个参数是该用户的id，第三个参数是是否记住用户，默认为false，因此通常可以省略。

等等。

好了，完成了！祝您玩得开心。

过滤器

正如预期的那样，由于原始的Auth语法中的Auth::guest()不再工作，因此默认过滤器也不工作。您可以修改过滤器使其类似于auth.admin和auth.user，但请记住，它们将不再工作。

有关旧auth过滤器的示例以及如何修复它的说明，请参阅此代码片段：https://gist.github.com/ollieread/8303638

测试

Laravel集成/控制器测试在基础TestCase类中实现了$this->be($user)。#be()的实现与Multiauth不正确地工作。为了解决这个问题，按照以下方式实现自己的#be()版本

public function authenticateAs($type, $user) {
  $this->app['auth']->$type()->setUser($user);
}

许可证

此软件包继承其父框架Laravel的许可权，因此是开源软件，根据MIT许可证许可

olliereadl5 / multiauth

维护者

详细信息

README

自定义认证驱动程序

安装

提醒

用法

过滤器

测试

许可证