用法 - SimpleAuth - Auth 套件

// 验证使用者名称和密码
if ($user = Auth::validate_user($name, $pass))
{
	// $name 和 $pass 的组合通过验证，印出使用者名称
	echo $user['username'];
}

// 执行登入
if (Auth::login($name, $pass))
{
	// 该使用者成功登入
}

// login 如果我们没登入
if ( ! Auth::check())
{
	Response::redirect('/login');
}

// 为使用者 12121 执行强制登入
if (Auth::force_login(12121))
{
	// 该使用者成功登入。任何先前登入的使用者会被登出！
}

// 执行登出
Auth::logout();

// 建立新使用者
Auth::create_user(
	'anewuser',
	'thisismysecretpassword',
	'anewuser@example.org',
	1,
	array(
		'fullname' => 'A. New User',
	)
);

// 为目前使用者更新资料
Auth::update_user(
	array(
		'email'        => 'anewemail@example.org',  // 设定一个新的 Email 地址
		'password'     => 'thisismynewpassword',    // 设定一个新密码
		'old_password' => 'thisismysecretpassword', // 要这样做，给目前的密码！
		'phone'        => '+1 (555) 123-1212',	    // 并且添加电话号码到诠释资料
	)
);

// 为目前使用者变更密码
Auth::change_password('mycurrentpassword','mynewpassword');

// 为目前使用者重设密码
$new_password = Auth::reset_password('thisusername');

// 删除使用者
Auth::delete_user('thisusername');

// 产生一个新的随机杂凑
Auth::create_login_hash();

// 取得使用者建立日期
$created_at = Auth::get('created_at');

// 取得所有登入 ID 资讯
$id_info = Auth::get_user_id();

// 印出驱动和 ID 资讯
if ($id_info)
{
	foreach ($id_info as $info)
	{
		echo 'Driver: ',$info[0],' with ID ',$info[1],'<br />';
	}
}
else
{
	echo 'Nobody is logged in!';
}

// 如果你只使用一个驱动，你也可以这样做
list($driver, $userid) = Auth::get_user_id();

// 或这样如果你只需要 userid
list(, $userid) = Auth::get_user_id();

// 取得所有群组 ID 资讯
$id_info = Auth::get_groups();

// 印出驱动和 ID 资讯
if ($id_info)
{
	foreach ($id_info as $info)
	{
		echo 'Driver: ',$info[0],' with group ID ',$info[1],'<br />';
	}
}
else
{
	echo 'Nobody is logged in!';
}

// 如果你只使用一个驱动，你也可以这样做
list($driver, $groupid) = Auth::get_groups();

// 取得目前使用者的 Email 地址
$email = Auth::get_email();

// 请注意，false 和 empty 之间有所不同：
if ($email === false)
{
	// 没有人登入
}
if (empty($email))
{
	// 使用者已登入，但没有 Email 地址
}

// 取得目前使用者的萤幕名称
$name = Auth::get_screen_name();

// 名称是必要的，所以如果没出现，表示没有人登入
if (empty($name))
{
	// 没有人登入
}

// 取得所有定义的个人设定栏位
$profile = Auth::get_profile_fields();

// 检查目前使用者是否为管理员
if (Auth::member(100))
{
	// 我们在管理员群组！
}

// 取得所有定义的群组（所有载入的 group 驱动）
$groups = Auth::groups();

// 从预设 group 驱动取得所有群组
$groups = Auth::group()->groups();

// 从指定驱动取得所有群组
$groups = Auth::group('Simplegroup')->groups();

// 取得所有定义的角色（所有载入的 acl 驱动）
$roles = Auth::roles();

// 从预设 acl 驱动取得所有角色
$roles = Auth::acl()->roles();

// 从指定驱动取得所有角色
$roles = Auth::acl('Simpleacl')->roles();

// 取得目前登入使用者所有群组的名称
$name = Auth::group()->get_name();

// 取得来自指定驱动指定群组的名称
$name = Auth::group('Simplegroup')->get_name(100);	// 回传 'Administrators'

// 检查使用者是否有阅读 blog 文章的存取权限
if (Auth::has_access('blog.read'))
{
	// 是的，使用者可存取
}

// 如果你有多个实例，使用该实例呼叫此方法。
// 你也可以一次检查多个权限
if (Auth::instance('simpleauth')->has_access('blog.[read,write,delete]'))
{
	// 是的，使用者有阅读、撰写和删除的存取权限
}

// 你也可以指定权限为阵列来检查
if (Auth::has_access(array('blog' => array('read'), 'comments' => array('read')))
{
	// 是的，使用者有阅读 blog 和评论的存取权限
}

// 如果你有多个 login 实例，你也可以取指定的 ACL 驱动
if (Auth::acl('simpleacl')->has_access('blog.[read,write,delete]'))
{
	// 是的，使用者有阅读、撰写和删除的存取权限
}

// 重导到 login 如果我们要求一个使用者且访客存取没有启用
if ( ! Auth::check() and ! Auth::guest_login())
{
	Response::redirect('/login');
}

// 处理登入表单 POST，并设定 remember-me cookie 如果需要
if (\Input::method() == 'POST')
{
	// 检查凭证。
	if (\Auth::instance()->login(\Input::param('username'), \Input::param('password')))
	{
		// 使用者想被记住吗？
		if (\Input::param('rememberme', false))
		{
// 建立 remember-me cookie
\Auth::remember_me();
		}
		else
		{
// 如果存在，删除 remember-me cookie
\Auth::dont_remember_me();
		}

		// 登入，往首页去
		\Response::redirect('/');
	}
	else
	{
		// 登入失败，显示一个错误讯息
		$data['username']    = \Input::param('username');
		$data['login_error'] = \Lang::get('login.failure');
	}
}