## Class Auth_OpenID_SQLStore

Description

This is the parent class for the SQL stores, which contains the logic common to all of the SQL stores.

The table names used are determined by the class variables associations_table_name and nonces_table_name. To change the name of the tables used, pass new table names into the constructor.

To create the tables with the proper schema, see the createTables method.

This class shouldn't be used directly. Use one of its subclasses instead, as those contain the code necessary to use a specific database. If you're an OpenID integrator and you'd like to create an SQL-driven store that wraps an application's database abstraction, be sure to create a subclass of Auth_OpenID_DatabaseConnection that calls the application's database abstraction calls. Then, pass an instance of your new database connection class to your SQLStore subclass constructor.

All methods other than the constructor and createTables should be considered implementation details.

- author: JanRain, Inc. <openid@janrain.com>

Located in /Auth/OpenID/SQLStore.php (line 67)

    Auth_OpenID_OpenIDStore
       |
       --Auth_OpenID_SQLStore

Direct descendents

Class | Description
--- | ---
Auth_OpenID_PostgreSQLStore | An SQL store that uses PostgreSQL as its backend.
Auth_OpenID_MySQLStore | An SQL store that uses MySQL as its backend.
Auth_OpenID_SQLiteStore | An SQL store that uses SQLite as its backend.

Method Summary
Auth_OpenID_SQLStore Auth_OpenID_SQLStore (connection $connection, [associations_table: $associations_table = null], [nonces_table: $nonces_table = null])
void blobDecode ( $blob)
void blobEncode ( $str)
void cleanupAssociations ()
void cleanupNonces ()
void createTables ()
void create_assoc_table ()
void create_nonce_table ()
void getAssociation ( $server_url, [ $handle = null])
void isError ( $value)
void removeAssociation ( $server_url, $handle)
void reset ()
void resultToBool ( $obj)
void setSQL ()
void storeAssociation ( $server_url, $association)
void tableExists ( $table_name)
void useNonce ( $server_url, $timestamp, $salt)
Methods
Constructor Auth_OpenID_SQLStore (line 88)

This creates a new SQLStore instance. It requires an established database connection be given to it, and it allows overriding the default table names.

Auth_OpenID_SQLStore Auth_OpenID_SQLStore (connection $connection, [associations_table: $associations_table = null], [nonces_table: $nonces_table = null])

- connection $connection: This must be an established connection to a database of the correct type for the SQLStore subclass you're using. This must either be an PEAR DB connection handle or an instance of a subclass of Auth_OpenID_DatabaseConnection.
- associations_table: $associations_table: This is an optional parameter to specify the name of the table used for storing associations. The default value is 'oid_associations'.
- nonces_table: $nonces_table: This is an optional parameter to specify the name of the table used for storing nonces. The default value is 'oid_nonces'.

blobDecode (line 288)
void blobDecode ( $blob)

- $blob

blobEncode (line 293)
void blobEncode ( $str)

- $str

cleanupAssociations (line 559)
void cleanupAssociations ()

Redefinition of:

Auth_OpenID_OpenIDStore::cleanupAssociations()

cleanupNonces (line 548)
void cleanupNonces ()

Redefinition of:

Auth_OpenID_OpenIDStore::cleanupNonces()

createTables (line 298)
void createTables ()
create_assoc_table (line 321)
void create_assoc_table ()
create_nonce_table (line 312)
void create_nonce_table ()
getAssociation (line 409)
void getAssociation ( $server_url, [ $handle = null])

- $server_url
- $handle

Redefinition of:

Auth_OpenID_OpenIDStore::getAssociation()
  This method returns an Association object from storage that matches the server URL and, if specified, handle. It returns null if no such association is found or if the matching association is expired.

isError (line 179)

Returns true if $value constitutes a database error; returns false otherwise.

void isError ( $value)

- $value

removeAssociation (line 392)
void removeAssociation ( $server_url, $handle)

- $server_url
- $handle

Redefinition of:

Auth_OpenID_OpenIDStore::removeAssociation()
  This method removes the matching association if it's found, and returns whether the association was removed or not.

reset (line 211)

Resets the store by removing all records from the store's tables.

void reset ()

Redefinition of:

Auth_OpenID_OpenIDStore::reset()
  Removes all entries from the store; implementation is optional.

resultToBool (line 189)

Converts a query result to a boolean. If the result is a database error according to $this->isError(), this returns false; otherwise, this returns true.

void resultToBool ( $obj)

- $obj

setSQL (line 203)

This method should be overridden by subclasses. This method is called by the constructor to set values in $this->sql, which is an array keyed on sql name.

void setSQL ()

Redefined in descendants as:

- Auth_OpenID_SQLiteStore::setSQL()

storeAssociation (line 346)
void storeAssociation ( $server_url, $association)

- $server_url
- $association

Redefinition of:

Auth_OpenID_OpenIDStore::storeAssociation()
  This method puts an Association object into storage, retrievable by server URL and handle.

tableExists (line 167)
void tableExists ( $table_name)

- $table_name

useNonce (line 480)
void useNonce ( $server_url, $timestamp, $salt)

- $server_url
- $timestamp
- $salt

Redefinition of:

Auth_OpenID_OpenIDStore::useNonce()
  Called when using a nonce.

#### Inherited Methods

Inherited From Auth_OpenID_OpenIDStore

> Auth_OpenID_OpenIDStore::cleanup()
> Auth_OpenID_OpenIDStore::cleanupAssociations()
> Auth_OpenID_OpenIDStore::cleanupNonces()
> Auth_OpenID_OpenIDStore::getAssociation()
> Auth_OpenID_OpenIDStore::removeAssociation()
> Auth_OpenID_OpenIDStore::reset()
> Auth_OpenID_OpenIDStore::storeAssociation()
> Auth_OpenID_OpenIDStore::supportsCleanup()
> Auth_OpenID_OpenIDStore::useNonce()

Documentation generated on Tue, 21 Apr 2009 11:31:33 -0700 by phpDocumentor 1.3.2