创建用户

创建用户 之 createUser 方法

创建用户并分配用户组

我们创建一个用户，并且为它分配用户组，他会继承自用户组的权限

  1. try
  2. {
  3.     // 创建一个用户 login字段是必须的 默认是 email 可配置，参考 [2.2 配置登陆字段](setlogin.md)
  4.     $user = Sentry::createUser(array(
  5.         'email'     => 'yccphp@163.com',
  6.         'password'  => '123456',
  7.         'activated' => true,
  8.     ));
  10.     // 查找用户组 where 为 组id ＝ 1
  11.     $adminGroup = Sentry::findGroupById(1);
  13.     // 把 用户加到 用户组
  14.     $user->addGroup($adminGroup);
  15. }
  16. catch (Cartalyst\Sentry\Users\LoginRequiredException $e)
  17. {
  18.     echo 'login 字段是必须的';
  19. }
  20. catch (Cartalyst\Sentry\Users\PasswordRequiredException $e)
  21. {
  22.     echo '没有提供密码';
  23. }
  24. catch (Cartalyst\Sentry\Users\UserExistsException $e)
  25. {
  26.     echo '用户已经存在';
  27. }
  28. catch (Cartalyst\Sentry\Groups\GroupNotFoundException $e)
  29. {
  30.     echo '用户组不存在';
  31. }

创建一个用户 单独设置权限

上面代码中，我们创建了一个用户，并且为他分配了用户组，继承了用户组的权限

但是，我们想一个用户，不加入用户组，但是又有自己的权限，sentry 可以帮我们实现吗？

答案是，必须的！

  1. try
  2. {
  3.     // 创建一个用户
  4.     $user = Sentry::createUser(array(
  5.         'email'       => 'yccphp@163.com',    // 邮箱
  6.         'password'    => '123456',            // 密码
  7.         'activated'   => true,                // 是否允许登陆
  8.         'permissions' => array(                // 权限组
  9.             'user.create' => -1,            // 拒绝访问  user.create
  10.             'user.delete' => -1,            // 拒绝访问  user.delete
  11.             'user.view'   => 1,                // 允许访问  user.view
  12.             'user.update' => 1,                // 允许访问  user.update
  13.         ),
  14.     ));
  15. }
  16. catch (Cartalyst\Sentry\Users\LoginRequiredException $e)
  17. {
  18.     echo 'login 字段是必须的';
  19. }
  20. catch (Cartalyst\Sentry\Users\PasswordRequiredException $e)
  21. {
  22.     echo '密码字段不存在'
  23. }
  24. catch (Cartalyst\Sentry\Users\UserExistsException $e)
  25. {
  26.     echo '创建的用户已经存在';
  27. }
  29. `

可以看到我们对 permissions 字段进行了赋值，这个字段正是表明了 这个用户有什么权限，我们看下用户的权限码

  1. -1 : 拒绝
  2.  1 : 允许
  3.  0 : 继承

我们可以限制用户，可以访问什么，不可以访问什么，权限控制的是不是很灵活呢 ？

-1 ，1 我们可以很轻易的理解，但是这个 0 权限继承是什么意思呢？

0 表示继承，继承自 分组！就是说，我们 设置权限 1 或者 -1 的时候，其实是覆盖了分组的权限，但是我们设置为 0 的时候，是继承自分组的权限哦！

创建用户 之 register 注册用户

上面我们讲解了 创建用户，本节我们讲解下 注册用户。

需求如下：
用户通过 表单注册用户，初始注册的 用户是不可以登录的，必须通过邮件激活用户，这个需求我们怎么做呢？

其实，在 sentry 中，为我们提供了 一条龙的 用户体系服务，这些 在 sentry 中都变的很简单

我们先讲解 注册用户，产生激活码吧

  1. try
  2. {
  3.     // 从表单收集的数据 注册用户
  4.     $user = Sentry::register(array(
  5.         'email'    => 'yccphp@163.com',
  6.         'password' => '123456',
  7.     ));
  9.     // 获取此用户的 激活码
  10.     $activationCode = $user->getActivationCode();
  12.     // 你可以继续 ，把激活码通过短信，或者 email 发送给 用户
  13. }
  14. catch (Cartalyst\Sentry\Users\LoginRequiredException $e)
  15. {
  16.     echo 'login 字段是必须的';
  17. }
  18. catch (Cartalyst\Sentry\Users\PasswordRequiredException $e)
  19. {
  20.     echo '没有提供密码';
  21. }
  22. catch (Cartalyst\Sentry\Users\UserExistsException $e)
  23. {
  24.     echo '用户已存在';
  25. }

我们看上面的代码，首先我们调用 register 注册了一个新用户，这个 register 的参数如下

Param Required Default Type Description
$credentials true null array 用户的资料。
$activate false false boolean 是否手动激活

我们看 第二个参数 activate ，默认是 false ，就是需要会员手动来激活。

我们上面的代码，就是需要会员手动激活，然后我们调用了 getActivationCode ，产生了一个 激活码，来作为激活用户的凭证

如果我们不需要会员手动激活，只需要要 把 第二个参数设置为 true ,就可以跳过此步骤

好了，我们已经完成了，注册用户，产生激活码的步骤了，至于怎么激活用户呢？请看 3.5激活用户