Docs For Class CalDAVRequest

CalDAVRequest

Description

A class for collecting things to do with this request.

Located in /inc/CalDAVRequest.php (line 27)

Variable Summary

mixed $collection_id

mixed $collection_path

mixed $collection_type

mixed $current_user_principal_xml

mixed $depth

mixed $exists

mixed $method

mixed $options

CalDAVPrincipal $principal

mixed $raw_post

mixed $supported_privileges

mixed $user_agent

Method Summary

CalDAVRequest __construct ([ $options = array()])

void AllowedTo (string $activity)

void BuildPrivileges ( $privilege_names)

void BuildSupportedMethods ()

void BuildSupportedPrivileges ([ $privs = null])

void BuildSupportedReports ()

void CollectionId ()

void dav_name ()

void DepthRegexTail ()

void DoResponse (int $status, [string $message = ""], [ $content_type = "text/plain; charset=\"utf-8\""])

mixed FailIfLocked ()

void GetDepthName ()

void GetLockDetails (string $lock_token)

void GetLockRow ( $lock_token, string $dav_name)

void IsAddressBook ()

void IsCalendar ()

void IsCollection ()

void IsInfiniteDepth ()

void IsLocked ()

void IsPrincipal ()

void IsProxyRequest ()

void IsPublic ()

void ServerProperty ( $tag, $prop, [ &$reply = null])

void setPermissions (int $user_no)

array SupportedPrivileges ()

void UnsupportedRequest (array $unsupported)

void UserFromPath ()

void ValidateLockToken (string $lock_token)

void XMLResponse (int $status, XMLElement $xmltree)

Variables

mixed $collection_id (line 67)

The ID of the collection containing this path, or of this path if it is a collection

mixed $collection_path (line 72)

The path corresponding to the collection_id

mixed $collection_type (line 78)

The type of collection being requested:

calendar, schedule-inbox, schedule-outbox

mixed $current_user_principal_xml (line 57)

The 'current_user_principal_xml' the DAV:current-user-principal answer. An XMLElement object with an <href> or <unauthenticated> fragment.

mixed $depth (line 45)

The depth parameter from the request headers, coerced into a valid integer: 0, 1 or DEPTH_INFINITY which is defined above. The default is set per various RFCs.

mixed $exists (line 84)

The type of collection being requested:

calendar, schedule-inbox, schedule-outbox

access: protected

mixed $method (line 39)

The HTTP request method: PROPFIND, LOCK, REPORT, OPTIONS, etc...

mixed $options (line 29)

CalDAVPrincipal $principal (line 51)

The 'principal' (user/resource/...) which this request seeks to access

mixed $raw_post (line 34)

The raw data sent along with the request

mixed $supported_privileges (line 89)

A static structure of supported privileges.

mixed $user_agent (line 62)

The user agent making the request.

Methods

Constructor __construct (line 94)

Create a new CalDAVRequest object.

CalDAVRequest __construct ([ $options = array()])

$options

AllowedTo (line 1007)

Are we allowed to do the requested activity

void AllowedTo (string $activity)

string $activity: The activity we want to do.

BuildPrivileges (line 885)

Returns the array of privilege names converted into XMLElements

void BuildPrivileges ( $privilege_names)

$privilege_names

BuildSupportedMethods (line 901)

Returns the array of supported methods converted into XMLElements

void BuildSupportedMethods ()

BuildSupportedPrivileges (line 856)

Returns the array of supported privileges converted into XMLElements

void BuildSupportedPrivileges ([ $privs = null])

$privs

BuildSupportedReports (line 915)

Returns the array of supported methods converted into XMLElements

void BuildSupportedReports ()

CollectionId (line 848)

Returns the ID of the collection of, or containing this request

void CollectionId ()

dav_name (line 654)

Returns the dav_name of the resource in our internal namespace

void dav_name ()

DepthRegexTail (line 672)

Returns the tail of a Regex appropriate for this Depth, when appended to

void DepthRegexTail ()

DoResponse (line 1106)

Utility function we call when we have a simple status-based response to return to the client. Possibly

void DoResponse (int $status, [string $message = ""], [ $content_type = "text/plain; charset=\"utf-8\""])

int $status: The HTTP status code to send.
string $message: The friendly text message to send with the response.
$content_type

FailIfLocked (line 754)

This will either (a) return false if no locks apply, or (b) return the lock_token which the request successfully included to open the lock, or: (c) respond directly to the client with the failure.

return: false (no lock) or opaquelocktoken (opened lock)

mixed FailIfLocked ()

GetDepthName (line 663)

Returns the name for this depth: 0, 1, infinity

void GetDepthName ()

GetLockDetails (line 740)

Returns the DB object associated with a lock token, or false.

void GetLockDetails (string $lock_token)

string $lock_token: The opaquelocktoken which we are looking for

GetLockRow (line 683)

Returns the locked row, either from the cache or from the database

void GetLockRow ( $lock_token, string $dav_name)

string $dav_name: The resource which we want to know the lock status for
$lock_token

IsAddressBook (line 809)

Returns true if the URL referenced by this request points at an addressbook collection.

void IsAddressBook ()

IsCalendar (line 800)

Returns true if the URL referenced by this request points at a calendar collection.

void IsCalendar ()

IsCollection (line 789)

Returns true if the URL referenced by this request points at a collection.

void IsCollection ()

IsInfiniteDepth (line 840)

Returns true if the request asked for infinite depth

void IsInfiniteDepth ()

IsLocked (line 611)

Checks whether the resource is locked, returning any lock token, or false

todo: This logic does not catch all locking scenarios. For example an infinite depth request should check the permissions for all collections and resources within that. At present we only maintain permissions on a per-collection basis though.

void IsLocked ()

IsPrincipal (line 818)

Returns true if the URL referenced by this request points at a principal.

void IsPrincipal ()

IsProxyRequest (line 829)

Returns true if the URL referenced by this request is within a proxy URL

void IsProxyRequest ()

IsPublic (line 643)

Checks whether the collection is public

void IsPublic ()

ServerProperty (line 931)

Return general server-related properties for this URL

void ServerProperty ( $tag, $prop, [ &$reply = null])

$tag
$prop
&$reply

setPermissions (line 543)

Permissions are controlled as follows:

if the path is '/', the request has read privileges
if the requester is an admin, the request has read/write priviliges
if there is a <user name> component which matches the logged on user then the request has read/write privileges
otherwise we query the defined relationships between users and use the minimum privileges returned from that analysis.

void setPermissions (int $user_no)

int $user_no: The current user number

SupportedPrivileges (line 1144)

Return an array of what the DAV privileges are that are supported

return: The supported privileges.

array SupportedPrivileges ()

UnsupportedRequest (line 1071)

Sometimes it's a perfectly formed request, but we just don't do that :-(

void UnsupportedRequest (array $unsupported)

array $unsupported: An array of the properties we don't support.

UserFromPath (line 496)

Work out the user whose calendar we are accessing, based on elements of the path.

void UserFromPath ()

ValidateLockToken (line 709)

Checks to see whether the lock token given matches one of the ones handed in with the request.

void ValidateLockToken (string $lock_token)

string $lock_token: The opaquelocktoken which we are looking for

XMLResponse (line 1091)

Send an XML Response. This function will never return.

void XMLResponse (int $status, XMLElement $xmltree)

int $status: The HTTP status to respond
XMLElement $xmltree: An XMLElement tree to be rendered

Documentation generated on Thu, 24 Dec 2009 22:09:51 +1300 by phpDocumentor 1.3.2