Class Auth_OpenID_MDB2Store
This store uses a PEAR::MDB2 connection to store persistence
information.
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.
-
Auth_OpenID_OpenIDStore
-
Auth_OpenID_MDB2Store
Methods summary
public
|
#
Auth_OpenID_MDB2Store( connection $connection, associations_table: $associations_table = null, nonces_table: $nonces_table = null )
This creates a new MDB2Store instance. It requires an
established database connection be given to it, and it allows
overriding the default table names.
This creates a new MDB2Store instance. It requires an
established database connection be given to it, and it allows
overriding the default table names.
Parameters
- $connection
This must be an established
connection to a database of the correct type for the SQLStore
subclass you're using. This must be a PEAR::MDB2 connection
handle. - $associations_table
is an optional parameter to
specify the name of the table used for storing associations.
The default value is 'oid_associations'. - $nonces_table
is an optional parameter to specify
the name of the table used for storing nonces. The default
value is 'oid_nonces'.
|
public
|
|
public
|
|
public
|
|
public
|
|
public
|
#
storeAssociation( string $server_url, Association $association )
This method puts an Association object into storage,
retrievable by server URL and handle.
This method puts an Association object into storage,
retrievable by server URL and handle.
Parameters
- $server_url
The URL of the identity server that
this association is with. Because of the way the server portion
of the library uses this interface, don't assume there are any
limitations on the character set of the input string. In
particular, expect to see unescaped non-url-safe characters in
the server_url field. - $association
- The Association to store.
Overrides
|
public
|
|
public
|
|
public
Association
|
#
getAssociation( string $server_url, mixed $handle = null )
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.
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.
If no handle is specified, the store may return any association
which matches the server URL. If multiple associations are
valid, the recommended return value for this method is the one
most recently issued.
This method is allowed (and encouraged) to garbage collect
expired associations when found. This method must not return
expired associations.
Parameters
- $server_url
The URL of the identity server to get
the association for. Because of the way the server portion of
the library uses this interface, don't assume there are any
limitations on the character set of the input string. In
particular, expect to see unescaped non-url-safe characters in
the server_url field. - $handle
This optional parameter is the handle of
the specific association to get. If no specific handle is
provided, any valid association matching the server URL is
returned. Returns
Association The Association for the given identity
server.
Overrides
|
public
mixed
|
#
removeAssociation( string $server_url, string $handle )
This method removes the matching association if it's found, and
returns whether the association was removed or not.
This method removes the matching association if it's found, and
returns whether the association was removed or not.
Parameters
- $server_url
The URL of the identity server the
association to remove belongs to. Because of the way the server
portion of the library uses this interface, don't assume there
are any limitations on the character set of the input
string. In particular, expect to see unescaped non-url-safe
characters in the server_url field. - $handle
This is the handle of the association to
remove. If there isn't an association found that matches both
the given URL and handle, then there was no matching handle
found. Returns
mixed
Returns whether or not the given association existed.
Overrides
|
public
boolean
|
#
useNonce( string $server_url, $timestamp, $salt )
Called when using a nonce.
Called when using a nonce.
This method should return C{True} if the nonce has not been
used before, and store it for a while to make sure nobody
tries to use the same value again. If the nonce has already
been used, return C{False}.
Change: In earlier versions, round-trip nonces were used and a
nonce was only valid if it had been previously stored with
storeNonce. Version 2.0 uses one-way nonces, requiring a
different implementation here that does not depend on a
storeNonce call. (storeNonce is no longer part of the
interface.
Parameters
- $server_url
- $nonce The nonce to use.
- $timestamp
- $salt
Returns
boolean
Whether or not the nonce was valid.
Overrides
|
public
|
#
reset( )
Resets the store by removing all records from the store's
tables.
Resets the store by removing all records from the store's
tables.
Overrides
|