Auth パッケージ

The Auth package provides a standardized interface for authentication in Fuel. This allows our users to write their own drivers and easily integrate a new driver to work with old code by keeping the basic methods consistent.

Auth_Group_Driver

This driver is the base class for all Auth group drivers. It is defined as an abstract class which contains all methods generic to all group drivers, and abstract method definitions for all methods any group driver MUST implement.

Driver configuration

A group driver can load additional drivers that it depends on. Generally, these are ACL drivers. But your implementation could introduce and use custom driver types as well. To do so, add this structure to your driver class: 

// autoload the SimpleAcl acl driver when loading this group driver
	protected $config = array(
		'drivers' => array('acl' => array('SimpleAcl'))
	);

Generic methods

Generic methods are defined in the group base driver, and are available to all Auth group drivers through extension. These methods provide functions to interact with groups, and to check for access.

The methods defined in the classes but not documented here are used internally, and should not be called directly.

get_id()

Returns the drivers unique id. This can be used to identify the driver, or to select a specific driver instance.

Static No
パラメータ None
返り値 The drivers id string.
例 
// returns 'simpleauth'
$id = Auth::instance('simplegroup')->get_id();

set_config($key, $value)

Sets a driver configuration value.

Static No
パラメータ
パラメータ 規定値 説明
$key required Configuration key name
$value required Value for this configuration key
返り値 void
例 
// set a config value on the simplegroup driver
Auth::instance('simplegroup')->set_config('key', 'value');

get_config($key, $default = null)

Gets a driver configuration value.

Static No
パラメータ
パラメータ 規定値 説明
$key required Configuration key name
$default null Default value to be returned if the requested key does not exist
返り値 mixed
例 
// get a config value of the simplegroup driver, return false if it doesn't exist
$key = Auth::instance(simplegroup)->get_config('key', false);

has_access($condition, $driver, $group = null)

The has_access method uses the defined ACL drivers to check the users access according to the given condition.

Static No
パラメータ
パラメータ 規定値 説明
$condition required takes a location and the required rights on the location as either a string or an array
$driver required ACL driver to query, or null if all loaded drivers should be called to check for access.
$group null Optionally, only check this group structure, instead of against all defined groups.
返り値 boolean, true if access was granted, false if not.
例 
// check if user is allowed to comment
if ( ! Auth::instance('simplegroup')->has_access('comments.create'), null)
{
	Response::redirect('no_admin');
}

// check if user can also update & delete comments
Auth::instance('simplegroup')->has_access('comments.[update,delete]', null);

// call statically (will use the default group driver instance)
Auth::has_access('comments.[update,delete]');

// The same with an array instead of a string
Auth::instance('simplegroup')->has_access(array('comments', array('update', 'delete')), null);

Abstract methods

Every group driver you develop MUST provide all of these methods, and the MUST return the values documented here.

member($group, $specific = null)

Checks if user is a member of the given group in either all loaded Group drivers or just those specified as the 2nd parameter.

Static Yes
パラメータ
パラメータ 規定値 説明
$group required group id
$specific null null to check all or one ore more driver id's (single string or array of strings)
返り値 bool, whether one of the (given) drivers had the current user registered as a member
例 
if ( ! Auth::member(100))
{
	Response::redirect('no_admin');
}

// specific driver
Auth::member(1, 'simplegroup');

// Multiple drivers
Auth::check(0, array('simplegroup', 'genericgroup'));

get_name($group)

Get the display name of the given group name.

Static Yes
パラメータ
パラメータ 規定値 説明
$group null name of the group you want to get the display name of
返り値 mixed, the retrieved group display name, or false if the given group does not exist.
例 
// get the display name of the admin group
Auth::instance('simplegroup')->get_name('admin');