Class: LiveUser_Auth_Container_MDB

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

Class Overview

LiveUser_Auth_Common
   |
   --LiveUser_Auth_Container_MDB

This is a PEAR::MDB backend driver for the LiveUser class.

Author(s):

Markus Wolff <wolff at 21st.de>

Version:

$Id: MDB.php,v 1.45 2004/09/15 19:22:29 arnaud 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
LiveUser_Auth_Common::$_stack

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::unfreeze(): Reinitializes properties
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 52]
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.45 2004/09/15 19:22:29 arnaud Exp $

[ Top ]

Class Variables

$authTable = 'liveuser_users'

[line 85]

Auth table Table where the auth data is stored.

Access: public

Type:

string

[ Top ]

$authTableCols = array(
'required' => array(
'auth_user_id' => array('name' => 'auth_user_id', 'type' => ''),'handle'=>array('name'=>'handle','type'=>''),'passwd'=>array('name'=>'passwd','type'=>''),),'optional'=>array('lastlogin'=>array('name'=>'lastlogin','type'=>''),'is_active'=>array('name'=>'is_active','type'=>'')))

[line 100]

Columns of the auth table.

Associative array with the names of the auth table columns. The 'auth_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.

The type attribute is only useful when using MDB or MDB2.

Access: public

Type:

array

[ Top ]

Method Detail

LiveUser_Auth_Container_MDB (Constructor) [line 119]

void LiveUser_Auth_Container_MDB(
array
&$connectOptions)

Class constructor.

Access: protected

Parameters:

array &$connectOptions — configuration array

[ Top ]

disconnect [line 158]

void disconnect(
)

Properly disconnect from database

Access: public

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

[ Top ]

userExists [line 304]

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

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: true 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 ]