[ class tree: OpenID ] [ index: OpenID ] [ all elements ]

Class: Auth_OpenID_SRegRequest

Source Location: /zp-extensions/federated_logon/Auth/OpenID/SReg.php

Class Auth_OpenID_SRegRequest

Class Overview

An object to hold the state of a simple registration request.

required: A list of the required fields in this simple registration request

optional: A list of the optional fields in this simple registration request

Located in /zp-extensions/federated_logon/Auth/OpenID/SReg.php [line 169]

Auth_OpenID_Extension
   |
   --Auth_OpenID_SRegBase
      |
      --Auth_OpenID_SRegRequest

Properties

Methods

[ Top ]
Inherited Properties, Constants, and Methods
Inherited Properties Inherited Methods Inherited Constants

Inherited From Auth_OpenID_Extension

Auth_OpenID_Extension::$ns_uri

Inherited From Auth_OpenID_Extension

Auth_OpenID_Extension::getExtensionArgs()
Get the string arguments that should be added to an OpenID message for this extension.
Auth_OpenID_Extension::toMessage()
Add the arguments from this extension to the provided message.

[ Top ]
Property Summary
mixed   $ns_alias  

[ Top ]
Method Summary
static void   build()   Initialize an empty simple registration request.
static void   fromOpenIDRequest()   Create a simple registration request that contains the fields that were requested in the OpenID request with the given arguments
void   allRequestedFields()   A list of all of the simple registration fields that were requested, whether they were required or optional.
void   contains()   Was this field in the request?
void   getExtensionArgs()   Get a dictionary of unqualified simple registration arguments representing this request.
void   parseExtensionArgs()   Parse the unqualified simple registration request parameters and add them to this object.
void   requestField()   Request the specified field from the OpenID user
void   requestFields()   Add the given list of fields to the request
void   wereFieldsRequested()   Have any simple registration fields been requested?

[ Top ]
Properties
mixed   $ns_alias = 'sreg' [line 171]

Redefinition of:
Auth_OpenID_Extension::$ns_alias

[ Top ]
Methods
static method build  [line 176]

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

Initialize an empty simple registration request.

Parameters:
   $required: 
   $optional: 
   $policy_url: 
   $sreg_ns_uri: 
   $cls: 


[ Top ]
static method fromOpenIDRequest  [line 216]

  static void fromOpenIDRequest( $request, [ $cls = 'Auth_OpenID_SRegRequest']  )

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

Parameters:
   $request: 
   $cls: 


[ Top ]
allRequestedFields  [line 287]

  void allRequestedFields( )

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



[ Top ]
contains  [line 303]

  void contains( $field_name  )

Was this field in the request?

Parameters:
   $field_name: 


[ Top ]
getExtensionArgs  [line 389]

  void 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.



Redefinition of:
Auth_OpenID_Extension::getExtensionArgs()
Get the string arguments that should be added to an OpenID message for this extension.

[ Top ]
parseExtensionArgs  [line 262]

  void 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)

Parameters:
   $args: 
   $strict: 


[ Top ]
requestField  [line 320]

  void 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

Parameters:
   $field_name: 
   $required: 
   $strict: 


[ Top ]
requestFields  [line 366]

  void 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

Parameters:
   $field_names: 
   $required: 
   $strict: 


[ Top ]
wereFieldsRequested  [line 295]

  void wereFieldsRequested( )

Have any simple registration fields been requested?



[ Top ]

Documentation generated on Tue, 20 Dec 2011 16:08:10 +0100 by phpDocumentor 1.4.3