FuelPHP，PHP 5.3 框架 简体中文手册

// 驗證使用者名稱和密码
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))
{
	// 該使用者成功登入。任何先前登入的使用者会被登出！
}

// 为使用者物件 12121 执行強制登入
$user = \Model\Auth_User::find(12121);
if (Auth::force_login($user))
{
	// 該使用者成功登入。任何先前登入的使用者会被登出！
}

// 执行登出
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('thisismynewpassword','thisismysecretpassword');

// 为目前使用者重設密码
$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]->id,'<br />';
	}
}
else
{
	echo 'Nobody is logged in!';
}

// 如果你只使用一个驅动，你也可以这樣做
list($driver, $group) = Auth::get_groups();
echo 'Driver: ',$driver,' with group ID ',$group->id,'<br />';

// 取得目前使用者的 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();

// 取得指定定義的个人設定欄位
$fullname = Auth::get_profile_fields('fullname', 'Unknown');

// 会回傳 null，因为 username 不是詮釋資料的一部分
$fullname = Auth::get_profile_fields('username', 'Unknown username');

// 檢查目前使用者是否为管理員
if (Auth::member(100))
{
	// 我們在管理員群組！
}

// 檢查目前使用者是否为管理員
$group = \Model\Auth_Group::find(100);
if (Auth::member($group))
{
	// 我們在管理員群組！
}

// 取得所有定義的群組（所有載入的 group 驅动）
$groups = Auth::groups();

// 從預設 group 驅动取得所有群組
$groups = Auth::group()->groups();

// 從指定驅动取得所有群組
$groups = Auth::group('Ormgroup')->groups();

// 取得所有定義的角色（所有載入的 acl 驅动）
$roles = Auth::roles();

// 從預設 acl 驅动取得所有角色
$roles = Auth::acl()->roles();

// 從指定驅动取得所有角色
$roles = Auth::acl('Ormacl')->roles();

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

// 取得來自指定驅动指定群組的名稱
$name = Auth::group('Ormgroup')->get_name(100);	// 回傳 'Administrators'

// 檢查使用者是否有閱讀 blog 文章的存取權限
if (Auth::has_access('blog.comments'))
{
	// 是的，使用者可存取
}

// 如果你有多个實例，使用該實例呼叫此方法。
// 你也可以一次檢查多个權限
if (Auth::instance('Ormauth')->has_access('blog.[posts,comments]'))
{
	// 是的，使用者有 blog 文章和評論兩者的存取權限
}

// 你也可以指定權限为陣列來檢查
if (Auth::has_access(array('blog' => array('post'), 'comments' => array('post')))
{
	// 是的，使用者有閱讀 blog 和評論文章兩者的存取權限
}

// 如果你有多个 login 實例，你也可以取指定的 ACL 驅动
if (Auth::acl('Ormacl')->has_access('blog.[posts,comments]'))
{
	// 是的，使用者有 blog 文章和評論兩者的存取權限
}

// 你可以透過使用權限动作來取得更細緻的權限
if (Auth::has_access('blog.comments[read,create,update,delete]'))
{
	// 是的，使用者有全部的 blog 評論存取權限
}

// 重導到 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');
	}
}