Auth_OpenID_SRegRequest Class Reference

Inheritance diagram for Auth_OpenID_SRegRequest:

Public Member Functions
	parseExtensionArgs ($args, $strict=false)
	allRequestedFields ()
	wereFieldsRequested ()
	contains ($field_name)
	requestField ($field_name, $required=false, $strict=false)
	requestFields ($field_names, $required=false, $strict=false)
	getExtensionArgs ()
Public Member Functions inherited from Auth_OpenID_Extension
	getExtensionArgs ()
	toMessage ($message, $request=null)

Static Public Member Functions
static	build ($required=null, $optional=null, $policy_url=null, $sreg_ns_uri=Auth_OpenID_SREG_NS_URI, $cls='Auth_OpenID_SRegRequest')
static	fromOpenIDRequest ($request, $cls='Auth_OpenID_SRegRequest')
Static Public Member Functions inherited from Auth_OpenID_SRegBase
static	_getSRegNS ($message)

Public Attributes
	$ns_alias = 'sreg'
Public Attributes inherited from Auth_OpenID_Extension
	$ns_uri = null
	$ns_alias = null

Detailed Description

Definition at line 169 of file SReg.php.

Member Function Documentation

allRequestedFields()

Auth_OpenID_SRegRequest::allRequestedFields

(

)

A list of all of the simple registration fields that were requested, whether they were required or optional.

Definition at line 287 of file SReg.php.

build()

static Auth_OpenID_SRegRequest::build (   $required = null,   $optional = null,   $policy_url = null,   $sreg_ns_uri = Auth_OpenID_SREG_NS_URI,   $cls = 'Auth_OpenID_SRegRequest'  )

static

Initialize an empty simple registration request.

Definition at line 176 of file SReg.php.

contains()

Auth_OpenID_SRegRequest::contains

(

$field_name

)

Was this field in the request?

Definition at line 303 of file SReg.php.

fromOpenIDRequest()

static Auth_OpenID_SRegRequest::fromOpenIDRequest (   $request,   $cls = 'Auth_OpenID_SRegRequest'  )

static

Create a simple registration request that contains the fields that were requested in the OpenID request with the given arguments

$request: The OpenID authentication request from which to extract an sreg request.

$cls: name of class to use when creating sreg request object. Used for testing.

Returns the newly created simple registration request

Definition at line 216 of file SReg.php.

References Auth_OpenID_SREG_NS_URI, and Auth_OpenID\isFailure().

getExtensionArgs()

Auth_OpenID_SRegRequest::getExtensionArgs

(

)

Get a dictionary of unqualified simple registration arguments representing this request.

This method is essentially the inverse of C{L{parseExtensionArgs}}. This method serializes the simple registration request fields.

Definition at line 389 of file SReg.php.

parseExtensionArgs()

Auth_OpenID_SRegRequest::parseExtensionArgs	(		$args,
			$strict = false
	)

Parse the unqualified simple registration request parameters and add them to this object.

This method is essentially the inverse of getExtensionArgs. This method restores the serialized simple registration request fields.

If you are extracting arguments from a standard OpenID checkid_* request, you probably want to use fromOpenIDRequest, which will extract the sreg namespace and arguments from the OpenID request. This method is intended for cases where the OpenID server needs more control over how the arguments are parsed than that method provides.

$args == $message->getArgs($ns_uri); $request->parseExtensionArgs($args);

$args: The unqualified simple registration arguments

strict: Whether requests with fields that are not defined in the simple registration specification should be tolerated (and ignored)

Definition at line 262 of file SReg.php.

References Auth_OpenID\arrayGet().

requestField()

Auth_OpenID_SRegRequest::requestField	(		$field_name,
			$required = false,
			$strict = false
	)

Request the specified field from the OpenID user

$field_name: the unqualified simple registration field name

required: whether the given field should be presented to the user as being a required to successfully complete the request

strict: whether to raise an exception when a field is added to a request more than once

Definition at line 320 of file SReg.php.

References Auth_OpenID_checkFieldName().

requestFields()

Auth_OpenID_SRegRequest::requestFields	(		$field_names,
			$required = false,
			$strict = false
	)

Add the given list of fields to the request

field_names: The simple registration data fields to request

required: Whether these values should be presented to the user as required

strict: whether to raise an exception when a field is added to a request more than once

Definition at line 366 of file SReg.php.

wereFieldsRequested()

Auth_OpenID_SRegRequest::wereFieldsRequested

(

)

Have any simple registration fields been requested?

Definition at line 295 of file SReg.php.

Member Data Documentation

$ns_alias

Auth_OpenID_SRegRequest::$ns_alias = 'sreg'

Definition at line 171 of file SReg.php.