Actualización

vendor/jeroendesloovere/vcard/src/VCardException.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace JeroenDesloovere\VCard;
+
+/*
+ * This file is part of the VCard PHP Class from Jeroen Desloovere.
+ *
+ * For the full copyright and license information, please view the license
+ * file that was distributed with this source code.
+ */
+
+/**
+ * VCard Exception PHP Class.
+ */
+class VCardException extends \Exception
+{
+    public static function elementAlreadyExists($element)
+    {
+        return new self('You can only set "' . $element . '" once.');
+    }
+
+    public static function emptyURL()
+    {
+        return new self('Nothing returned from URL.');
+    }
+
+    public static function invalidImage()
+    {
+        return new self('Returned data is not an image.');
+    }
+
+    public static function outputDirectoryNotExists()
+    {
+        return new self('Output directory does not exist.');
+    }
+}

vendor/jeroendesloovere/vcard/src/VCardParser.php

@@ -0,0 +1,341 @@
+<?php
+
+namespace JeroenDesloovere\VCard;
+
+/*
+ * This file is part of the VCard PHP Class from Jeroen Desloovere.
+ *
+ * For the full copyright and license information, please view the license
+ * file that was distributed with this source code.
+ */
+
+use Iterator;
+use OutOfBoundsException;
+use RuntimeException;
+use stdClass;
+
+/**
+ * VCard PHP Class to parse .vcard files.
+ *
+ * This class is heavily based on the Zendvcard project (seemingly abandoned),
+ * which is licensed under the Apache 2.0 license.
+ * More information can be found at https://code.google.com/archive/p/zendvcard/
+ */
+class VCardParser implements Iterator
+{
+    /**
+     * The raw VCard content.
+    *
+     * @var string
+     */
+    protected $content;
+
+    /**
+     * The VCard data objects.
+     *
+     * @var array
+     */
+    protected $vcardObjects;
+
+    /**
+     * The iterator position.
+     *
+     * @var int
+     */
+    protected $position;
+
+    /**
+     * Helper function to parse a file directly.
+     *
+     * @param string $filename
+     * @return self
+     */
+    public static function parseFromFile($filename)
+    {
+        if (file_exists($filename) && is_readable($filename)) {
+            return new self(file_get_contents($filename));
+        } else {
+            throw new \RuntimeException(sprintf("File %s is not readable, or doesn't exist.", $filename));
+        }
+    }
+
+    public function __construct($content)
+    {
+        $this->content = $content;
+        $this->vcardObjects = [];
+        $this->rewind();
+        $this->parse();
+    }
+
+    public function rewind(): void
+    {
+        $this->position = 0;
+    }
+
+    public function current(): \stdClass
+    {
+        if (! $this->valid()) {
+            throw new RuntimeException('invalid');
+        }
+
+        return $this->getCardAtIndex($this->position);
+    }
+
+    public function key(): int
+    {
+        return $this->position;
+    }
+
+    public function next(): void
+    {
+        $this->position++;
+    }
+
+    public function valid(): bool
+    {
+        return !empty($this->vcardObjects[$this->position]);
+    }
+
+    /**
+     * Fetch all the imported VCards.
+     *
+     * @return array
+     *    A list of VCard card data objects.
+     */
+    public function getCards(): array
+    {
+        return $this->vcardObjects;
+    }
+
+    /**
+     * Fetch the imported VCard at the specified index.
+     *
+     * @throws OutOfBoundsException
+     *
+     * @param int $i
+     *
+     * @return stdClass
+     *    The card data object.
+     */
+    public function getCardAtIndex($i): stdClass
+    {
+        if (isset($this->vcardObjects[$i])) {
+            return $this->vcardObjects[$i];
+        }
+        throw new \OutOfBoundsException();
+    }
+
+    /**
+     * Start the parsing process.
+     *
+     * This method will populate the data object.
+     */
+    protected function parse()
+    {
+        // Normalize new lines.
+        $this->content = str_replace(["\r\n", "\r"], "\n", $this->content);
+
+        // RFC2425 5.8.1. Line delimiting and folding
+        // Unfolding is accomplished by regarding CRLF immediately followed by
+        // a white space character (namely HTAB ASCII decimal 9 or. SPACE ASCII
+        // decimal 32) as equivalent to no characters at all (i.e., the CRLF
+        // and single white space character are removed).
+        $this->content = preg_replace("/\n(?:[ \t])/", "", $this->content);
+        $lines = explode("\n", $this->content);
+
+        // Parse the VCard, line by line.
+        foreach ($lines as $line) {
+            $line = trim($line);
+
+            if (strtoupper($line) == "BEGIN:VCARD") {
+                $cardData = new \stdClass();
+            } elseif (strtoupper($line) == "END:VCARD") {
+                $this->vcardObjects[] = $cardData;
+            } elseif (!empty($line)) {
+                // Strip grouping information. We don't use the group names. We
+                // simply use a list for entries that have multiple values.
+                // As per RFC, group names are alphanumerical, and end with a
+                // period (.).
+                $line = preg_replace('/^\w+\./', '', $line);
+
+                $type = '';
+                $value = '';
+                @list($type, $value) = explode(':', $line, 2);
+
+                $types = explode(';', $type);
+                $element = strtoupper($types[0]);
+
+                array_shift($types);
+
+                // Normalize types. A type can either be a type-param directly,
+                // or can be prefixed with "type=". E.g.: "INTERNET" or
+                // "type=INTERNET".
+                if (!empty($types)) {
+                    $types = array_map(function($type) {
+                        return preg_replace('/^type=/i', '', $type);
+                    }, $types);
+                }
+
+                $i = 0;
+                $rawValue = false;
+                foreach ($types as $type) {
+                    if (preg_match('/base64/', strtolower($type))) {
+                        $value = base64_decode($value);
+                        unset($types[$i]);
+                        $rawValue = true;
+                    } elseif (preg_match('/encoding=b/', strtolower($type))) {
+                        $value = base64_decode($value);
+                        unset($types[$i]);
+                        $rawValue = true;
+                    } elseif (preg_match('/quoted-printable/', strtolower($type))) {
+                        $value = quoted_printable_decode($value);
+                        unset($types[$i]);
+                        $rawValue = true;
+                    } elseif (strpos(strtolower($type), 'charset=') === 0) {
+                        try {
+                            $value = mb_convert_encoding($value, "UTF-8", substr($type, 8));
+                        } catch (\Exception $e) {
+                        }
+                        unset($types[$i]);
+                    }
+                    $i++;
+                }
+
+                switch (strtoupper($element)) {
+                    case 'FN':
+                        $cardData->fullname = $value;
+                        break;
+                    case 'N':
+                        foreach ($this->parseName($value) as $key => $val) {
+                            $cardData->{$key} = $val;
+                        }
+                        break;
+                    case 'BDAY':
+                        $cardData->birthday = $this->parseBirthday($value);
+                        break;
+                    case 'ADR':
+                        if (!isset($cardData->address)) {
+                            $cardData->address = [];
+                        }
+                        $key = !empty($types) ? implode(';', $types) : 'WORK;POSTAL';
+                        $cardData->address[$key][] = $this->parseAddress($value);
+                        break;
+                    case 'TEL':
+                        if (!isset($cardData->phone)) {
+                            $cardData->phone = [];
+                        }
+                        $key = !empty($types) ? implode(';', $types) : 'default';
+                        $cardData->phone[$key][] = $value;
+                        break;
+                    case 'EMAIL':
+                        if (!isset($cardData->email)) {
+                            $cardData->email = [];
+                        }
+                        $key = !empty($types) ? implode(';', $types) : 'default';
+                        $cardData->email[$key][] = $value;
+                        break;
+                    case 'REV':
+                        $cardData->revision = $value;
+                        break;
+                    case 'VERSION':
+                        $cardData->version = $value;
+                        break;
+                    case 'ORG':
+                        $cardData->organization = $value;
+                        break;
+                    case 'URL':
+                        if (!isset($cardData->url)) {
+                            $cardData->url = [];
+                        }
+                        $key = !empty($types) ? implode(';', $types) : 'default';
+                        $cardData->url[$key][] = $value;
+                        break;
+                    case 'TITLE':
+                        $cardData->title = $value;
+                        break;
+                    case 'PHOTO':
+                        if ($rawValue) {
+                            $cardData->rawPhoto = $value;
+                        } else {
+                            $cardData->photo = $value;
+                        }
+                        break;
+                    case 'LOGO':
+                        if ($rawValue) {
+                            $cardData->rawLogo = $value;
+                        } else {
+                            $cardData->logo = $value;
+                        }
+                        break;
+                    case 'NOTE':
+                        $cardData->note = $this->unescape($value);
+                        break;
+                    case 'CATEGORIES':
+                        $cardData->categories = array_map('trim', explode(',', $value));
+                        break;
+                    case 'LABEL':
+                        $cardData->label = $value;
+                        break;
+                }
+            }
+        }
+    }
+
+    protected function parseName($value)
+    {
+        @list(
+            $lastname,
+            $firstname,
+            $additional,
+            $prefix,
+            $suffix
+        ) = explode(';', $value);
+        return (object) [
+            'lastname' => $lastname,
+            'firstname' => $firstname,
+            'additional' => $additional,
+            'prefix' => $prefix,
+            'suffix' => $suffix,
+        ];
+    }
+
+    protected function parseBirthday($value)
+    {
+        return new \DateTime($value);
+    }
+
+    protected function parseAddress($value)
+    {
+        @list(
+            $name,
+            $extended,
+            $street,
+            $city,
+            $region,
+            $zip,
+            $country,
+        ) = explode(';', $value);
+        return (object) [
+            'name' => $name,
+            'extended' => $extended,
+            'street' => $street,
+            'city' => $city,
+            'region' => $region,
+            'zip' => $zip,
+            'country' => $country,
+        ];
+    }
+
+    /**
+     * Unescape newline characters according to RFC2425 section 5.8.4.
+     * This function will replace escaped line breaks with PHP_EOL.
+     *
+     * @link http://tools.ietf.org/html/rfc2425#section-5.8.4
+     * @param  string $text
+     * @return string
+     */
+    protected function unescape($text)
+    {
+        return str_replace("\\n", PHP_EOL, $text);
+    }
+}