File Auth driver. [!!] this Auth driver does not support roles nor autologin.
Class declared in MODPATH/auth/classes/Auth/File.php on line 3.
NULL
NULL
NULL
NULL
Constructor loads the user list into the class.
publicfunction__construct($config= []){parent::__construct($config);// Load user list$this->_users = Arr::get($config,'users', []);}
Compare password with original (plain text). Works for current (logged in) user
string
$password
required - Password boolean
publicfunctioncheck_password($password){$username=$this->get_user();if($username=== false) {returnfalse;}return($password===$this->password($username));}
Forces a user to be logged in, without specifying a password.
mixed
$username
required - Username boolean
publicfunctionforce_login($username){// Complete the loginreturn$this->complete_login($username);}
Get the stored password for a username.
mixed
$username
required - Username string
publicfunctionpassword($username){returnArr::get($this->_users,$username, false);}
Gets the currently logged in user from the session. Returns null if no user is currently logged in.
mixed
$default
= NULL - Default value to return if the user is currently not logged in. mixed
publicfunctionget_user($default= null){return$this->_session->get($this->_config['session_key'],$default);}
Perform a hmac hash, using the configured method.
string
$str
required - String to hash string
publicfunctionhash($str){if(!$this->_config['hash_key'])thrownewKohana_Exception('A valid hash key must be set in your auth config.');returnhash_hmac($this->_config['hash_method'],$str,$this->_config['hash_key']);}
Singleton pattern
Auth
publicstaticfunctioninstance(){if(!isset(Auth::$_instance)) {// Load the configuration for this type$config= Kohana::$config->load('auth');if(!$type=$config->get('driver')) {$type='file';}// Set the session class name$class='Auth_'. ucfirst($type);// Create a new session instanceAuth::$_instance=new$class($config);}returnAuth::$_instance;}
Check if there is an active session. Optionally allows checking for a specific role.
string
$role
= NULL - Role name mixed
publicfunctionlogged_in($role= null){return($this->get_user() !== null);}
Attempt to log in a user by using an ORM object and plain-text password.
string
$username
required - Username to log in string
$password
required - Password to check against boolean
$remember
= bool FALSE - Enable autologin boolean
publicfunctionlogin($username,$password,$remember= false){if(empty($password))returnfalse;return$this->_login($username,$password,$remember);}
Log out a user by removing the related session variables.
boolean
$destroy
= bool FALSE - Completely destroy the session boolean
$logout_all
= bool FALSE - Remove all tokens for user boolean
publicfunctionlogout($destroy= false,$logout_all= false){if($destroy=== true) {// Destroy the session completely$this->_session->destroy();}else{// Remove the user from the session$this->_session->delete($this->_config['session_key']);// Regenerate session_id$this->_session->regenerate();}// Double checkreturn!$this->logged_in();}
Logs a user in.
string
$username
required - Username string
$password
required - Password boolean
$remember
required - Enable autologin (not supported) boolean
protectedfunction_login($username,$password,$remember){if(is_string($password)) {// Create a hashed password$password=$this->hash($password);}if(isset($this->_users[$username]) AND$this->_users[$username] ===$password) {// Complete the loginreturn$this->complete_login($username);}// Login failedreturnfalse;}
protectedfunctioncomplete_login($user){// Regenerate session_id$this->_session->regenerate();// Store username in session$this->_session->set($this->_config['session_key'],$user);returntrue;}