Class: LiveUser_Auth_Container_XML

Source Location: /LiveUser-0.11.0/Auth/Container/XML.php

Class Overview

LiveUser_Auth_Common
   |
   --LiveUser_Auth_Container_XML

Class LiveUser_Auth_Container_XML

Author(s):

krausbn at php.net>

Version:

$Id: XML.php,v 1.14 2004/03/08 21:04:22 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 43]
Class LiveUser_Auth_Container_XML

Description: This is a XML backend driver for the LiveUser class.

Author: krausbn@php.net>
Version: $Id: XML.php,v 1.14 2004/03/08 21:04:22 lsmith Exp $

[ Top ]

Method Detail

LiveUser_Auth_Container_XML (Constructor) [line 74]

LiveUser_Auth_Container_XML &LiveUser_Auth_Container_XML(
mixed
&$connectOptions)

LiveUser_Auth_Container_XML::LiveUser_Auth_Container_XML()

Class constructor.

Parameters:

mixed &$connectOptions —

[ Top ]

disconnect [line 112]

void disconnect(
)

properly disconnect from resources

Access: public

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

[ Top ]

readUserData [line 192]

boolean readUserData(
string
$userHandle, [mixed
$userPasswd = false])

LiveUser_Auth_Container_XML::readUserData()

Reads auth_user_id, password from the xml file 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 passwd 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	`$userHandle`	—	Handle of the current user.
mixed	`$userPasswd`	—	Can be a string with an unencrypted pwd or false.

[ Top ]

userExists [line 272]

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.

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 ]