Class: LiveUser_Auth_Container_MDB

Source Location: /LiveUser-0.11.1/Auth/Container/MDB.php

Class Overview

LiveUser_Auth_Common
   |
   --LiveUser_Auth_Container_MDB

Class LiveUser_Auth_Container_MDB

Author(s):

Markus Wolff <wolff at 21st.de>

Version:

$Id: MDB.php,v 1.27 2004/04/24 17:28:41 lsmith Exp $

Inherited Variables

Class: LiveUser_Auth_Common

LiveUser_Auth_Common::$allowDuplicateHandles
LiveUser_Auth_Common::$authUserId
LiveUser_Auth_Common::$backendArrayIndex
LiveUser_Auth_Common::$currentLogin
LiveUser_Auth_Common::$encryptionModes
LiveUser_Auth_Common::$expireTime
LiveUser_Auth_Common::$handle
LiveUser_Auth_Common::$idleTime
LiveUser_Auth_Common::$init_ok
LiveUser_Auth_Common::$isActive
LiveUser_Auth_Common::$lastLogin
LiveUser_Auth_Common::$loggedIn
LiveUser_Auth_Common::$loginTimeout
LiveUser_Auth_Common::$passwd
LiveUser_Auth_Common::$passwordEncryptionMode

Inherited Methods

Class: LiveUser_Auth_Common

LiveUser_Auth_Common::LiveUser_Auth_Common(): Class constructor. Feel free to override in backend subclasses.
LiveUser_Auth_Common::decryptPW(): Decrypts a password so that it can be compared with the user input. Uses the algorithm defined in the passwordEncryptionMode property.
LiveUser_Auth_Common::disconnect(): properly disconnect from resources
LiveUser_Auth_Common::encryptPW(): Encrypts a password for storage in a backend container.
LiveUser_Auth_Common::freeze(): store all properties in an array
LiveUser_Auth_Common::getProperty(): Function returns the inquired value if it exists in the class.
LiveUser_Auth_Common::isNewLogin(): Checks if there's enough time between lastLogin and current login (now) to count as a new login.
LiveUser_Auth_Common::login(): Tries to make a login with the given handle and password.
LiveUser_Auth_Common::readUserData(): Reads auth_user_id, passwd, is_active flag
LiveUser_Auth_Common::unfreeze(): Reinitializes properties
LiveUser_Auth_Common::updateUserData(): Writes current values for user back to the database.
LiveUser_Auth_Common::userExists(): Helper function that checks if there is a user in the database who's matching the given parameters.

Class Details

[line 55]
Class LiveUser_Auth_Container_MDB

Description: This is a PEAR::MDB backend driver for the LiveUser class. A PEAR::MDB connection object can be passed to the constructor to reuse an existing connection. Alternatively, a DSN can be passed to open a new one.

Requirements:

File "LoginManager.php" (contains the parent class "LiveUser")
Array of connection options or a PEAR::MDB connection object must be passed to the constructor. Example: array('dsn' => 'mysql://user:pass@host/db_name', 'connection => &$conn, # PEAR::MDB connection object 'loginTimeout' => 0, 'allowDuplicateHandles' => 1);

Author: Markus Wolff <wolff@21st.de>
Version: $Id: MDB.php,v 1.27 2004/04/24 17:28:41 lsmith Exp $

[ Top ]

Class Variables

$authTable = 'liveuser_users'

[line 91]

Auth table Table where the auth data is stored.

Access: public

Type:

string

[ Top ]

$authTableCols = array('user_id' => array('name' => 'auth_user_id', 'type' => 'text'),'handle'=>array('name'=>'handle','type'=>'text'),'passwd'=>array('name'=>'passwd','type'=>'text'),'lastlogin'=>array('name'=>'lastlogin','type'=>'timestamp'),'is_active'=>array('name'=>'is_active','type'=>'boolean'))

[line 104]

Columns of the auth table.

Associative array with the names of the auth table columns. The 'user_id', 'handle' and 'passwd' fields have to be set. 'lastlogin' and 'is_active' are optional. It doesn't make sense to set only one of the time columns without the other.

Access: public

Type:

array

[ Top ]

Method Detail

LiveUser_Auth_Container_MDB (Constructor) [line 117]

LiveUser_Auth_Container_MDB &LiveUser_Auth_Container_MDB(
mixed
&$connectOptions)

LiveUser_Auth_Container_MDB::LiveUser_Auth_Container_MDB()

Class constructor.

Parameters:

mixed &$connectOptions —

[ Top ]

disconnect [line 150]

void disconnect(
)

properly disconnect from resources

Access: public

Overrides LiveUser_Auth_Common::disconnect() (properly disconnect from resources)

[ Top ]

readUserData [line 206]

boolean readUserData(
string
$handle, [boolean
$passwd = false])

LiveUser_Auth_Container_MDB::readUserData()

Reads auth_user_id, passwd, is_active flag lastlogin timestamp from the database If only $handle is given, it will read the data from the first user with that handle and return true on success. If $handle and $passwd are given, it will try to find the first user with both handle and password matching and return true on success (this allows multiple users having the same handle but different passwords - yep, some people want this). If no match is found, false is being returned.

Overrides LiveUser_Auth_Common::readUserData() (Reads auth_user_id, passwd, is_active flag)

Parameters:

string	`$handle`	—
boolean	`$passwd`	—

[ Top ]

userExists [line 282]

mixed userExists(
[boolean
$checkHandle = false], [boolean
$checkPW = false])

LiveUser_Auth_Container_MDB::userExists()

Helper function that checks if there is a user in the database who's matching the given parameters. If $checkHandle is given and $checkPW is set to false, it only checks if a user with that handle exists. If only $checkPW is given and $checkHandle is set to false, it will check if there exists a user with that password. If both values are set to anything but false, it will find the first user in the database with both values matching. Please note:

If no match was found, the return value is false
If a match was found, the auth_user_id from the database is being returned

Whatever is returned, please keep in mind that this function only searches for the _first_ occurence of the search values in the database. So when you have multiple users with the same handle, only the ID of the first one is returned. Same goes for passwords. Searching for both password and handle should be pretty safe, though - having more than one user with the same handle/password combination in the database would be pretty stupid anyway.

Return: auth_user_id DB error or false if the user does not exist

Overrides LiveUser_Auth_Common::userExists() (Helper function that checks if there is a user in the database who's matching the given parameters.)

Parameters:

boolean	`$checkHandle`	—	The handle (username) to search
boolean	`$checkPW`	—	The password to check against

[ Top ]