aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/sabre/dav/lib/DAV/Xml/Property/Href.php
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/sabre/dav/lib/DAV/Xml/Property/Href.php')
-rw-r--r--vendor/sabre/dav/lib/DAV/Xml/Property/Href.php176
1 files changed, 176 insertions, 0 deletions
diff --git a/vendor/sabre/dav/lib/DAV/Xml/Property/Href.php b/vendor/sabre/dav/lib/DAV/Xml/Property/Href.php
new file mode 100644
index 000000000..538e98d0f
--- /dev/null
+++ b/vendor/sabre/dav/lib/DAV/Xml/Property/Href.php
@@ -0,0 +1,176 @@
+<?php
+
+namespace Sabre\DAV\Xml\Property;
+
+use Sabre\DAV\Browser\HtmlOutput;
+use Sabre\DAV\Browser\HtmlOutputHelper;
+use Sabre\Xml\Element;
+use Sabre\Xml\Reader;
+use Sabre\Xml\Writer;
+
+/**
+ * Href property
+ *
+ * This class represents any WebDAV property that contains a {DAV:}href
+ * element, and there are many.
+ *
+ * It can support either 1 or more hrefs. If while unserializing no valid
+ * {DAV:}href elements were found, this property will unserialize itself as
+ * null.
+ *
+ * @copyright Copyright (C) fruux GmbH (https://fruux.com/)
+ * @author Evert Pot (http://www.rooftopsolutions.nl/)
+ * @license http://sabre.io/license/ Modified BSD License
+ */
+class Href implements Element, HtmlOutput {
+
+ /**
+ * List of uris
+ *
+ * @var array
+ */
+ protected $hrefs;
+
+ /**
+ * Automatically prefix the url with the server base directory
+ *
+ * @var bool
+ */
+ protected $autoPrefix = true;
+
+ /**
+ * Constructor
+ *
+ * You must either pass a string for a single href, or an array of hrefs.
+ *
+ * If auto-prefix is set to false, the hrefs will be treated as absolute
+ * and not relative to the servers base uri.
+ *
+ * @param string|string[] $href
+ * @param bool $autoPrefix
+ */
+ function __construct($hrefs, $autoPrefix = true) {
+
+ if (is_string($hrefs)) {
+ $hrefs = [$hrefs];
+ }
+ $this->hrefs = $hrefs;
+ $this->autoPrefix = $autoPrefix;
+
+
+ }
+
+ /**
+ * Returns the first Href.
+ *
+ * @return string
+ */
+ function getHref() {
+
+ return $this->hrefs[0];
+
+ }
+
+ /**
+ * Returns the hrefs as an array
+ *
+ * @return array
+ */
+ function getHrefs() {
+
+ return $this->hrefs;
+
+ }
+
+ /**
+ * The xmlSerialize metod is called during xml writing.
+ *
+ * Use the $writer argument to write its own xml serialization.
+ *
+ * An important note: do _not_ create a parent element. Any element
+ * implementing XmlSerializble should only ever write what's considered
+ * its 'inner xml'.
+ *
+ * The parent of the current element is responsible for writing a
+ * containing element.
+ *
+ * This allows serializers to be re-used for different element names.
+ *
+ * If you are opening new elements, you must also close them again.
+ *
+ * @param Writer $writer
+ * @return void
+ */
+ function xmlSerialize(Writer $writer) {
+
+ foreach ($this->getHrefs() as $href) {
+ if ($this->autoPrefix) {
+ $href = $writer->contextUri . \Sabre\HTTP\encodePath($href);
+ }
+ $writer->writeElement('{DAV:}href', $href);
+ }
+
+ }
+
+ /**
+ * Generate html representation for this value.
+ *
+ * The html output is 100% trusted, and no effort is being made to sanitize
+ * it. It's up to the implementor to sanitize user provided values.
+ *
+ * The output must be in UTF-8.
+ *
+ * The baseUri parameter is a url to the root of the application, and can
+ * be used to construct local links.
+ *
+ * @param HtmlOutputHelper $html
+ * @return string
+ */
+ function toHtml(HtmlOutputHelper $html) {
+
+ $links = [];
+ foreach ($this->getHrefs() as $href) {
+ $links[] = $html->link($href);
+ }
+ return implode('<br />', $links);
+
+ }
+
+ /**
+ * 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) {
+
+ $hrefs = [];
+ foreach ((array)$reader->parseInnerTree() as $elem) {
+ if ($elem['name'] !== '{DAV:}href')
+ continue;
+
+ $hrefs[] = $elem['value'];
+
+ }
+ if ($hrefs) {
+ return new self($hrefs, false);
+ }
+
+ }
+
+}