<?php namespace Sabre\CardDAV\Xml\Request; use Sabre\Xml\Reader; use Sabre\Xml\XmlDeserializable; use Sabre\DAV\Exception\BadRequest; use Sabre\CardDAV\Plugin; /** * AddressBookQueryReport request parser. * * This class parses the {urn:ietf:params:xml:ns:carddav}addressbook-query * REPORT, as defined in: * * http://tools.ietf.org/html/rfc6352#section-8.6 * * @copyright Copyright (C) 2007-2013 Rooftop Solutions. All rights reserved. * @author Evert Pot (http://www.rooftopsolutions.nl/) * @license http://sabre.io/license/ Modified BSD License */ class AddressBookQueryReport implements XmlDeserializable { /** * An array with requested properties. * * @var array */ public $properties; /** * List of property/component filters. * * This is an array with filters. Every item is a property filter. Every * property filter has the following keys: * * name - name of the component to filter on * * test - anyof or allof * * is-not-defined - Test for non-existence * * param-filters - A list of parameter filters on the property * * text-matches - A list of text values the filter needs to match * * Each param-filter has the following keys: * * name - name of the parameter * * is-not-defined - Test for non-existence * * text-match - Match the parameter value * * Each text-match in property filters, and the single text-match in * param-filters have the following keys: * * * value - value to match * * match-type - contains, starts-with, ends-with, equals * * negate-condition - Do the opposite match * * collation - Usually i;unicode-casemap * * @var array */ public $filters; /** * The number of results the client wants * * null means it wasn't specified, which in most cases means 'all results'. * * @var int|null */ public $limit; /** * Either 'anyof' or 'allof' * * @var string */ public $test; /** * The mimetype of the content that should be returend. Usually * text/vcard. * * @var string */ public $contentType = null; /** * The version of vcard data that should be returned. Usually 3.0, * referring to vCard 3.0. * * @var string */ public $version = null; /** * The deserialize method is called during xml parsing. * * This method is called statictly, this is because in theory this method * may be used as a type of constructor, or factory method. * * Often you want to return an instance of the current class, but you are * free to return other data as well. * * You are responsible for advancing the reader to the next element. Not * doing anything will result in a never-ending loop. * * If you just want to skip parsing for this element altogether, you can * just call $reader->next(); * * $reader->parseInnerTree() will parse the entire sub-tree, and advance to * the next element. * * @param Reader $reader * @return mixed */ static function xmlDeserialize(Reader $reader) { $elems = (array)$reader->parseInnerTree([ '{urn:ietf:params:xml:ns:carddav}prop-filter' => 'Sabre\\CardDAV\\Xml\\Filter\\PropFilter', '{urn:ietf:params:xml:ns:carddav}param-filter' => 'Sabre\\CardDAV\\Xml\\Filter\\ParamFilter', '{urn:ietf:params:xml:ns:carddav}address-data' => 'Sabre\\CardDAV\\Xml\\Filter\\AddressData', '{DAV:}prop' => 'Sabre\\Xml\\Element\\KeyValue', ]); $newProps = [ 'filters' => null, 'properties' => [], 'test' => 'anyof', 'limit' => null, ]; if (!is_array($elems)) $elems = []; foreach ($elems as $elem) { switch ($elem['name']) { case '{DAV:}prop' : $newProps['properties'] = array_keys($elem['value']); if (isset($elem['value']['{' . Plugin::NS_CARDDAV . '}address-data'])) { $newProps += $elem['value']['{' . Plugin::NS_CARDDAV . '}address-data']; } break; case '{' . Plugin::NS_CARDDAV . '}filter' : if (!is_null($newProps['filters'])) { throw new BadRequest('You can only include 1 {' . Plugin::NS_CARDDAV . '}filter element'); } if (isset($elem['attributes']['test'])) { $newProps['test'] = $elem['attributes']['test']; if ($newProps['test'] !== 'allof' && $newProps['test'] !== 'anyof') { throw new BadRequest('The "test" attribute must be one of "allof" or "anyof"'); } } $newProps['filters'] = []; foreach ((array)$elem['value'] as $subElem) { if ($subElem['name'] === '{' . Plugin::NS_CARDDAV . '}prop-filter') { $newProps['filters'][] = $subElem['value']; } } break; case '{' . Plugin::NS_CARDDAV . '}limit' : foreach ($elem['value'] as $child) { if ($child['name'] === '{' . Plugin::NS_CARDDAV . '}nresults') { $newProps['limit'] = (int)$child['value']; } } break; } } if (is_null($newProps['filters'])) { /* * We are supposed to throw this error, but KDE sometimes does not * include the filter element, and we need to treat it as if no * filters are supplied */ //throw new BadRequest('The {' . Plugin::NS_CARDDAV . '}filter element is required for this request'); $newProps['filters'] = []; } $obj = new self(); foreach ($newProps as $key => $value) { $obj->$key = $value; } return $obj; } }