Class Auth_Yadis_Discovery

State management for discovery.

High-level usage pattern is to call .getNextService(discover) in order to find the next available service for this user for this session. Once a request completes, call .cleanup() to clean up the session state.

Package: OpenID
Located at zp-extensions/federated_logon/Auth/Yadis/Manager.php

Methods summary
`public`	# `Auth_Yadis_Discovery( Auth_Yadis_PHPSession $session, string $url, string $session_key_suffix = null )` Initialize a discovery object. Initialize a discovery object. Parameters `$session` An object which implements the Auth_Yadis_PHPSession API. `$url` The URL on which to attempt discovery. `$session_key_suffix` The optional session key suffix override.
`public`	# `getNextService( $discover_cb, $fetcher )` Return the next authentication service for the pair of user_input and session. This function handles fallback. Return the next authentication service for the pair of user_input and session. This function handles fallback.
`public`	# `cleanup( $force = false )` Clean up Yadis-related services in the session and return the most-recently-attempted service from the manager, if one exists. Clean up Yadis-related services in the session and return the most-recently-attempted service from the manager, if one exists. Parameters `$force` if the manager should be deleted regardless of whether it's a manager for $this->url.
`public`	# `getSessionKey( )`
`public`	# `getManager( $force = false )` Parameters `$force` if the manager should be returned regardless of whether it's a manager for $this->url.
`public`	# `createManager( $services, $yadis_url = null )`
`public`	# `destroyManager( $force = false )` Parameters `$force` if the manager should be deleted regardless of whether it's a manager for $this->url.

Properties summary
`public string`	`$DEFAULT_SUFFIX`	# `'auth'`
`public string`	`$PREFIX`	# `'_yadis_services_'`