class.ilvCard.php

Go to the documentation of this file.

<?php
 
// Address values for the ADR type
const ADR_TYPE_NONE = 0;
const ADR_TYPE_DOM = 1;
const ADR_TYPE_INTL = 2;
const ADR_TYPE_POSTAL = 4;
const ADR_TYPE_PARCEL = 8;
const ADR_TYPE_HOME = 16;
const ADR_TYPE_WORK = 32;
const ADR_TYPE_PREF = 64;
 
// Communication values for the TEL type
const TEL_TYPE_NONE = 0;
const TEL_TYPE_HOME = 1;
const TEL_TYPE_MSG = 2;
const TEL_TYPE_WORK = 4;
const TEL_TYPE_PREF = 8;
const TEL_TYPE_VOICE = 16;
const TEL_TYPE_FAX = 32;
const TEL_TYPE_CELL = 64;
const TEL_TYPE_VIDEO = 128;
const TEL_TYPE_PAGER = 256;
const TEL_TYPE_BBS = 512;
const TEL_TYPE_MODEM = 1024;
const TEL_TYPE_CAR = 2048;
const TEL_TYPE_ISDN = 4096;
const TEL_TYPE_PCS = 8192;
 
// Communication values for the EMAIL type
const EMAIL_TYPE_NONE = 0;
const EMAIL_TYPE_INTERNET = 1;
const EMAIL_TYPE_x400 = 2;
const EMAIL_TYPE_PREF = 4;
 
class ilvCard
{
    public array $types;
 
    // The filename of the vCard used when saving the vCard
    public string $filename;
 
    public function __construct(string $version = "3.0")
    {
        $this->types = array(
            "FN" => "",
            "N" => "",
            "NICKNAME" => "",
            "PHOTO" => array(),
            "BDAY" => "",
            "ADR" => array(),
            "LABEL" => array(),
            "TEL" => array(),
            "EMAIL" => array(),
            "MAILER" => "",
            "TZ" => "",
            "GEO" => "",
            "TITLE" => "",
            "ROLE" => "",
            "LOGO" => array(),
            "AGENT" => "",
            "ORG" => "",
            "CATEGORIES" => "",
            "NOTE" => "",
            "PRODID" => "",
            "REV" => "",
            "SORT-STRING" => "",
            "SOUND" => array(),
            "UID" => "",
            "URL" => "",
            "CLASS" => "",
            "KEY" => array()
        );
        $this->types["VERSION"] = $version;
    }
 
    public function encode(string $string): string
    {
        return $this->escape(quoted_printable_encode($string));
    }
 
    public function fold(string $string = ""): string
    {
        $folded_string = "";
        preg_match_all("/(.{1,74})/", $string, $matches);
        for ($i = 0, $iMax = count($matches[1]); $i < $iMax; $i++) {
            if ($i < (count($matches[1]) - 1)) {
                $matches[1][$i] .= "\n";
            }
            if ($i > 0) {
                $matches[1][$i] = " " . $matches[1][$i];
            }
            $folded_string .= $matches[1][$i];
        }
        return $folded_string;
    }
 
    public function escape(string $string): string
    {
        $string = preg_replace("/(?<!\\\\)(\\\\)([^;,n\\\\])/", "\${1}\${1}\${2}", $string);
        $string = preg_replace("/(?<!\\\\);/", "\\;", $string);
        $string = preg_replace("/(?<!\\\\),/", "\\,", $string);
        $string = preg_replace("/\n/", "\\n", $string);
        return $string;
    }
 
    public function explodeVar(string $variable, string $separator = ","): array
    {
        $exploded = explode($separator, $variable);
        foreach ($exploded as $index => $var) {
            $exploded[$index] = $this->escape($var);
        }
        return $exploded;
    }
 
    public function buildVCard(): string
    {
        $fn = $n = $nickname = $photo = $bday = $adr = $label = $tel = $email = $mailer =
        $tz = $geo = $title = $role = $logo = $agent = $org = $categories = $note = $prodid =
        $rev = $sortstring = $sound = $uid = $url = $class = $key = 0;
 
        $vcard = "BEGIN:VCARD\n";
        $vcard .= "VERSION:" . $this->types["VERSION"] . "\n";
        foreach ($this->types as $type => $var) {
            ilLoggerFactory::getLogger('user')->debug(print_r($this->types, true));
 
            switch ($type) {
                case "FN":
                    if (strcmp($this->types["FN"], "") != 0) {
                        $fn = $this->fold("FN:" . $this->types["FN"]) . "\n";
                    } else {
                        $fn = "";
                    }
                    break;
                case "N":
                    if (strcmp($this->types["N"], "") != 0) {
                        $n = $this->fold("N:" . $this->types["N"]) . "\n";
                    } else {
                        $n = "";
                    }
                    break;
                case "NICKNAME":
                    if (strcmp($this->types["NICKNAME"], "") != 0) {
                        $nickname = $this->fold("NICKNAME:" . $this->types["NICKNAME"]) . "\n";
                    } else {
                        $nickname = "";
                    }
                    break;
                case "PHOTO":
                    $photo = "";
                    if (isset($this->types["PHOTO"])) {
                        if (strcmp(($this->types["PHOTO"]["VALUE"] ?? ""), "") != 0) {
                            $photo = $this->fold("PHOTO;VALUE=uri:" . $this->types["PHOTO"]["VALUE"]) . "\n";
                        } elseif (strcmp(($this->types["PHOTO"]["ENCODING"] ?? ""), "") != 0) {
                            $photo = "PHOTO;ENCODING=" . $this->types["PHOTO"]["ENCODING"];
                            if (strcmp($this->types["PHOTO"]["TYPE"], "") != 0) {
                                $photo .= ";TYPE=" . $this->types["PHOTO"]["TYPE"];
                            }
                            $photo .= ":" . $this->types["PHOTO"]["PHOTO"];
                            $photo = $this->fold($photo) . "\n";
                        }
                    }
                    break;
                case "BDAY":
                    if (strcmp($this->types["BDAY"], "") != 0) {
                        $bday = $this->fold("BDAY:" . $this->types["BDAY"]) . "\n";
                    } else {
                        $bday = "";
                    }
                    break;
                case "ADR":
                    if (count($this->types["ADR"])) {
                        $addresses = "";
                        foreach ($this->types["ADR"] as $key => $address) {
                            $test = implode('', $address);
                            if (strcmp($test, "") != 0) {
                                $adr = "ADR";
                                $adr_types = array();
                                if ($address["TYPE"] > 0) {
                                    if (($address["TYPE"] & ADR_TYPE_DOM) > 0) {
                                        $adr_types[] = "dom";
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_INTL) > 0) {
                                        $adr_types[] = "intl";
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_POSTAL) > 0) {
                                        $adr_types[] = "postal";
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_PARCEL) > 0) {
                                        $adr_types[] = "parcel";
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_HOME) > 0) {
                                        $adr_types[] = "home";
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_WORK) > 0) {
                                        $adr_types[] = "work";
                                    }
                                    if (($address["TYPE"] & ADR_TYPE_PREF) > 0) {
                                        $adr_types[] = "pref";
                                    }
                                    $adr .= ";TYPE=" . implode(",", $adr_types);
                                }
                                $adr .= ":" . $address["POBOX"] . ";" . $address["EXTENDED_ADDRESS"] .
                                    ";" . $address["STREET_ADDRESS"] . ";" . $address["LOCALITY"] .
                                    ";" . $address["REGION"] . ";" . $address["POSTAL_CODE"] .
                                    ";" . $address["COUNTRY"];
                                $adr = $this->fold($adr) . "\n";
                                $addresses .= $adr;
                            }
                        }
                        $adr = $addresses;
                    } else {
                        $adr = "";
                    }
                    break;
                case "LABEL":
                    $label = "";
                    if (isset($this->types["LABEL"])) {
                        if (strcmp(($this->types["LABEL"]["LABEL"] ?? ""), "") != 0) {
                            $label = "LABEL";
                            $adr_types = array();
                            if ($this->types["LABEL"]["TYPE"] > 0) {
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_DOM) > 0) {
                                    $adr_types[] = "dom";
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_INTL) > 0) {
                                    $adr_types[] = "intl";
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_POSTAL) > 0) {
                                    $adr_types[] = "postal";
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_PARCEL) > 0) {
                                    $adr_types[] = "parcel";
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_HOME) > 0) {
                                    $adr_types[] = "home";
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_WORK) > 0) {
                                    $adr_types[] = "work";
                                }
                                if (($this->types["LABEL"]["TYPE"] & ADR_TYPE_PREF) > 0) {
                                    $adr_types[] = "pref";
                                }
                                $label .= ";TYPE=" . implode(",", $adr_types);
                            }
                            $label .= ":" . $this->types["LABEL"]["LABEL"];
                            $label = $this->fold($label) . "\n";
                        }
                    }
                    break;
                case "TEL":
                    if (count($this->types["TEL"])) {
                        $phonenumbers = "";
                        foreach ($this->types["TEL"] as $key => $phone) {
                            if (strcmp($phone["TEL"], "") != 0) {
                                $tel = "TEL";
                                $tel_types = array();
                                if ($phone["TYPE"] > 0) {
                                    if (($phone["TYPE"] & TEL_TYPE_HOME) > 0) {
                                        $tel_types[] = "home";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_MSG) > 0) {
                                        $tel_types[] = "msg";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_WORK) > 0) {
                                        $tel_types[] = "work";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_PREF) > 0) {
                                        $tel_types[] = "pref";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_VOICE) > 0) {
                                        $tel_types[] = "voice";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_FAX) > 0) {
                                        $tel_types[] = "fax";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_CELL) > 0) {
                                        $tel_types[] = "cell";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_VIDEO) > 0) {
                                        $tel_types[] = "video";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_PAGER) > 0) {
                                        $tel_types[] = "pager";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_BBS) > 0) {
                                        $tel_types[] = "bbs";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_MODEM) > 0) {
                                        $tel_types[] = "modem";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_CAR) > 0) {
                                        $tel_types[] = "car";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_ISDN) > 0) {
                                        $tel_types[] = "isdn";
                                    }
                                    if (($phone["TYPE"] & TEL_TYPE_PCS) > 0) {
                                        $tel_types[] = "pcs";
                                    }
                                    $tel .= ";TYPE=" . implode(",", $tel_types);
                                }
                                $tel .= ":" . $phone["TEL"];
                                $tel = $this->fold($tel) . "\n";
                                $phonenumbers .= $tel;
                            }
                        }
                        $tel = $phonenumbers;
                    } else {
                        $tel = "";
                    }
                    break;
                case "EMAIL":
                    if (count($this->types["EMAIL"])) {
                        $emails = "";
                        foreach ($this->types["EMAIL"] as $key => $mail) {
                            if (strcmp($mail["EMAIL"], "") != 0) {
                                $email = "EMAIL";
                                $adr_types = array();
                                if ($mail["TYPE"] > 0) {
                                    if (($mail["TYPE"] & EMAIL_TYPE_INTERNET) > 0) {
                                        $adr_types[] = "internet";
                                    }
                                    if (($mail["TYPE"] & EMAIL_TYPE_x400) > 0) {
                                        $adr_types[] = "x400";
                                    }
                                    if (($mail["TYPE"] & EMAIL_TYPE_PREF) > 0) {
                                        $adr_types[] = "pref";
                                    }
                                    $email .= ";TYPE=" . implode(",", $adr_types);
                                }
                                $email .= ":" . $mail["EMAIL"];
                                $email = $this->fold($email) . "\n";
                                $emails .= $email;
                            }
                        }
                        $email = $emails;
                    } else {
                        $email = "";
                    }
                    break;
                case "MAILER":
                    if (strcmp(($this->types["MAILER"] ?? ""), "") != 0) {
                        $mailer = $this->fold("MAILER:" . $this->types["MAILER"]) . "\n";
                    } else {
                        $mailer = "";
                    }
                    break;
                case "TZ":
                    if (strcmp(($this->types["TZ"] ?? ""), "") != 0) {
                        $tz = $this->fold("TZ:" . $this->types["TZ"]) . "\n";
                    } else {
                        $tz = "";
                    }
                    break;
                case "GEO":
                    if (isset($this->types["GEO"]) and
                        (strcmp(($this->types["GEO"]["LAT"] ?? ""), "") != 0) and
                        (strcmp(($this->types["GEO"]["LON"] ?? ""), "") != 0)) {
                        $geo = $this->fold(
                            "GEO:" . $this->types["GEO"]["LAT"] . ";" . $this->types["GEO"]["LON"]
                        ) . "\n";
                    } else {
                        $geo = "";
                    }
                    break;
                case "TITLE":
                    if (strcmp(($this->types["TITLE"] ?? ""), "") != 0) {
                        $title = $this->fold("TITLE:" . $this->types["TITLE"]) . "\n";
                    } else {
                        $title = "";
                    }
                    break;
                case "ROLE":
                    if (strcmp(($this->types["ROLE"] ?? ""), "") != 0) {
                        $role = $this->fold("ROLE:" . $this->types["ROLE"]) . "\n";
                    } else {
                        $role = "";
                    }
                    break;
                case "LOGO":
                    $logo = "";
                    if (isset($this->types["LOGO"])) {
                        if (strcmp(($this->types["LOGO"]["VALUE"] ?? ""), "") != 0) {
                            $logo = $this->fold("LOGO;VALUE=uri:" . $this->types["LOGO"]["VALUE"]) . "\n";
                        } elseif (strcmp(($this->types["LOGO"]["ENCODING"] ?? ""), "") != 0) {
                            $logo = "LOGO;ENCODING=" . $this->types["LOGO"]["ENCODING"];
                            if (strcmp($this->types["LOGO"]["TYPE"], "") != 0) {
                                $logo .= ";TYPE=" . $this->types["LOGO"]["TYPE"];
                            }
                            $logo .= ":" . $this->types["LOGO"]["LOGO"];
                            $logo = $this->fold($logo) . "\n";
                        }
                    }
                    break;
                case "AGENT":
                    if (strcmp(($this->types["AGENT"] ?? ""), "") != 0) {
                        $agent = $this->fold("AGENT:" . $this->types["AGENT"]) . "\n";
                    } else {
                        $agent = "";
                    }
                    break;
                case "ORG":
                    if (strcmp(($this->types["ORG"] ?? ""), "") != 0) {
                        $org = $this->fold("ORG:" . $this->types["ORG"]) . "\n";
                    } else {
                        $org = "";
                    }
                    break;
                case "CATEGORIES":
                    if (strcmp(($this->types["CATEGORIES"] ?? ""), "") != 0) {
                        $categories = $this->fold("CATEGORIES:" . $this->types["CATEGORIES"]) . "\n";
                    } else {
                        $categories = "";
                    }
                    break;
                case "NOTE":
                    if (strcmp(($this->types["NOTE"] ?? ""), "") != 0) {
                        $note = $this->fold("NOTE:" . $this->types["NOTE"]) . "\n";
                    } else {
                        $note = "";
                    }
                    break;
                case "PRODID":
                    if (strcmp(($this->types["PRODID"] ?? ""), "") != 0) {
                        $prodid = $this->fold("PRODID:" . $this->types["PRODID"]) . "\n";
                    } else {
                        $prodid = "";
                    }
                    break;
                case "REV":
                    if (strcmp(($this->types["REV"] ?? ""), "") != 0) {
                        $rev = $this->fold("REV:" . $this->types["REV"]) . "\n";
                    } else {
                        $rev = "";
                    }
                    break;
                case "SORT-STRING":
                    if (strcmp(($this->types["SORT-STRING"] ?? ""), "") != 0) {
                        $sortstring = $this->fold("SORT-STRING:" . $this->types["SORT-STRING"]) . "\n";
                    } else {
                        $sortstring = "";
                    }
                    break;
                case "SOUND":
                    $sound = "";
                    if (isset($this->types["SOUND"])) {
                        if (strcmp(($this->types["SOUND"]["VALUE"] ?? ""), "") != 0) {
                            $sound = $this->fold("SOUND;VALUE=uri:" . $this->types["SOUND"]["VALUE"]) . "\n";
                        } elseif (strcmp(($this->types["SOUND"]["ENCODING"] ?? ""), "") != 0) {
                            $sound = "SOUND;ENCODING=" . $this->types["SOUND"]["ENCODING"];
                            if (strcmp($this->types["SOUND"]["TYPE"], "") != 0) {
                                $sound .= ";TYPE=" . $this->types["SOUND"]["TYPE"];
                            }
                            $sound .= ":" . $this->types["SOUND"]["SOUND"];
                            $sound = $this->fold($sound) . "\n";
                        }
                    }
                    break;
                case "UID":
                    $uid = "";
                    if (isset($this->types["UID"])) {
                        if (strcmp(($this->types["UID"]["UID"] ?? ""), "") != 0) {
                            $uid = "UID";
                            if (strcmp($this->types["UID"]["TYPE"], "") != 0) {
                                $uid .= ";TYPE=" . $this->types["UID"]["TYPE"];
                            }
                            $uid .= ":" . $this->types["UID"]["UID"];
                            $uid = $this->fold($uid) . "\n";
                        }
                    }
                    break;
                case "URL":
                    if (strcmp(($this->types["URL"] ?? ""), "") != 0) {
                        $url = $this->fold("URL:" . $this->types["URL"]) . "\n";
                    } else {
                        $url = "";
                    }
                    break;
                case "KEY":
                    $key = "";
                    if (isset($this->types["KEY"])) {
                        if (strcmp(($this->types["KEY"]["KEY"] ?? ""), "") != 0) {
                            $key = "KEY";
                            if (strcmp($this->types["KEY"]["TYPE"], "") != 0) {
                                $key .= ";TYPE=" . $this->types["KEY"]["TYPE"];
                            }
                            if (strcmp($this->types["KEY"]["ENCODING"], "") != 0) {
                                $key .= ";ENCODING=" . $this->types["KEY"]["ENCODING"];
                            }
                            $key .= ":" . $this->types["KEY"]["KEY"];
                            $key = $this->fold($key) . "\n";
                        }
                    }
                    break;
                case "CLASS":
                    if (strcmp(($this->types["CLASS"] ?? ""), "") != 0) {
                        $class = $this->fold("CLASS:" . $this->types["CLASS"]) . "\n";
                    } else {
                        $class = "";
                    }
                    break;
            }
        }
        $vcard .= $fn . $n . $nickname . $photo . $bday . $adr . $label . $tel . $email . $mailer .
            $tz . $geo . $title . $role . $logo . $agent . $org . $categories . $note . $prodid .
            $rev . $sortstring . $sound . $uid . $url . $class . $key;
        $vcard .= "END:vCard\n";
        return $vcard;
    }
 
    public function quoted_printable_encode(string $input, int $line_max = 76): string
    {
        $hex = array('0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F');
        $lines = preg_split("/(\r\n|\r|\n)/", $input);
        $eol = "\r\n";
        $linebreak = "=0D=0A";
        $escape = "=";
        $output = "";
 
        for ($j = 0, $jMax = count($lines); $j < $jMax; $j++) {
            $line = $lines[$j];
            $linlen = strlen($line);
            $newline = "";
            for ($i = 0; $i < $linlen; $i++) {
                $c = substr($line, $i, 1);
                $dec = ord($c);
                if (($dec == 32) && ($i == ($linlen - 1))) { // convert space at eol only
                    $c = "=20";
                } elseif (($dec == 61) || ($dec < 32) || ($dec > 126)) { // always encode "\t", which is *not* required
                    $h2 = floor($dec / 16);
                    $h1 = floor($dec % 16);
                    $c = $escape . $hex[(string) $h2] . $hex[(string) $h1];
                }
                if ((strlen($newline) + strlen($c)) >= $line_max) { // CRLF is not counted
                    $output .= $newline . $escape . $eol; // soft line break; " =\r\n" is okay
                    $newline = "    ";
                }
                $newline .= $c;
            } // end of for
            $output .= $newline;
            if ($j < count($lines) - 1) {
                $output .= $linebreak;
            }
        }
        return trim($output);
    }
 
    // Identification Types
    // These types are used in the vCard profile to capture information
    // associated with the identification and naming of the person or
    // resource associated with the vCard.
 
    public function setFormattedName(string $formatted_name): void
    {
        $this->types["FN"] = $this->escape($formatted_name);
    }
 
    public function setName(
        string $family_name,
        string $given_name = "",
        string $additional_names = "",
        string $honorific_prefixes = "",
        string $honorific_suffixes = ""
    ): void {
        $familynames = $this->explodeVar($family_name);
        $givennames = $this->explodeVar($given_name);
        $addnames = $this->explodeVar($additional_names);
        $prefixes = $this->explodeVar($honorific_prefixes);
        $suffixes = $this->explodeVar($honorific_suffixes);
 
        $this->types["N"] =
            implode(",", $familynames) .
            ";" .
            implode(",", $givennames) .
            ";" .
            implode(",", $addnames) .
            ";" .
            implode(",", $prefixes) .
            ";" .
            implode(",", $suffixes);
 
        $this->filename = $given_name . "_" . $family_name . ".vcf";
        if (strcmp($this->types["FN"], "") === 0) {
            $fn = trim("$honorific_prefixes $given_name $additional_names $family_name $honorific_suffixes");
            $fn = preg_replace("/\s{2,10}/", " ", $fn);
            $this->setFormattedName($fn);
        }
    }
 
    public function setNickname(string $nickname): void
    {
        $nicknames = $this->explodeVar($nickname);
        $this->types["NICKNAME"] = implode(",", $nicknames);
    }
 
    public function setPhoto(
        string $photo,
        string $type = ""
    ): void {
        $value = "";
        $encoding = "";
        if (preg_match("/^http/", $photo)) {
            $value = $this->encode($photo);
        } else {
            $encoding = "b";
            $photo = base64_encode($photo);
        }
        $this->types["PHOTO"] = array(
            "VALUE" => $value,
            "TYPE" => $type,
            "ENCODING" => $encoding,
            "PHOTO" => $photo
        );
    }
 
    public function setBirthday(int $year, int $month, int $day): void
    {
        if (($year < 1) or ($day < 1) or ($month < 1)) {
            $this->types["BDAY"] = "";
        } else {
            $this->types["BDAY"] = sprintf("%04d-%02d-%02d", $year, $month, $day);
        }
    }
 
    // Delivery Addressing Types
    // These types are concerned with information related to the delivery
    // addressing or label for the vCard object.
 
    public function setAddress(
        string $po_box = "",
        string $extended_address = "",
        string $street_address = "",
        string $locality = "",
        string $region = "",
        string $postal_code = "",
        string $country = "",
        int $type = ADR_TYPE_NONE
    ): void {
        if ($type == ADR_TYPE_NONE) {
            $type = ADR_TYPE_INTL + ADR_TYPE_POSTAL + ADR_TYPE_PARCEL + ADR_TYPE_WORK;
        }
        $po_box = implode(",", $this->explodeVar($po_box));
        $extended_address = implode(",", $this->explodeVar($extended_address));
        $street_address = implode(",", $this->explodeVar($street_address));
        $locality = implode(",", $this->explodeVar($locality));
        $region = implode(",", $this->explodeVar($region));
        $postal_code = implode(",", $this->explodeVar($postal_code));
        $country = implode(",", $this->explodeVar($country));
        $this->types["ADR"][] = array(
            "POBOX" => $po_box,
            "EXTENDED_ADDRESS" => $extended_address,
            "STREET_ADDRESS" => $street_address,
            "LOCALITY" => $locality,
            "REGION" => $region,
            "POSTAL_CODE" => $postal_code,
            "COUNTRY" => $country,
            "TYPE" => $type
        );
    }
 
    public function setLabel(
        string $label = "",
        int $type = ADR_TYPE_NONE
    ): void {
        if ($type == ADR_TYPE_NONE) {
            $type = ADR_TYPE_INTL + ADR_TYPE_POSTAL + ADR_TYPE_PARCEL + ADR_TYPE_WORK;
        }
        $this->types["LABEL"] = array(
            "LABEL" => $this->escape($label),
            "TYPE" => $type
        );
    }
 
    // Telecommunications Addressing Types
    // These types are concerned with information associated with the
    // telecommunications addressing of the object the vCard represents.
 
    public function setPhone(
        string $number = "",
        int $type = TEL_TYPE_VOICE
    ): void {
        $this->types["TEL"][] = array(
            "TEL" => $this->escape($number),
            "TYPE" => $type
        );
    }
 
    public function setEmail(
        string $address = "",
        int $type = EMAIL_TYPE_INTERNET
    ): void {
        $this->types["EMAIL"][] = array(
            "EMAIL" => $this->escape($address),
            "TYPE" => $type
        );
    }
 
    public function setMailer(string $name = ""): void
    {
        $this->types["MAILER"] = $this->escape($name);
    }
 
    // Geographical Types
    // These types are concerned with information associated with
    // geographical positions or regions associated with the object the
    // vCard represents.
 
    public function setTimezone(string $zone = ""): void
    {
        $this->types["TZ"] = $this->escape($zone);
    }
 
    public function setPosition(string $latitude = "", string $longitude = ""): void
    {
        $this->types["GEO"] = array(
            "LAT" => $latitude,
            "LON" => $longitude
        );
    }
 
    // Organizational Types
    // These types are concerned with information associated with
    // characteristics of the organization or organizational units of the
    // object the vCard represents.
 
    public function setTitle(string $title = ""): void
    {
        $this->types["TITLE"] = $this->escape($title);
    }
 
    public function setRole(string $role = ""): void
    {
        $this->types["ROLE"] = $this->escape($role);
    }
 
    public function setLogo(string $logo, string $type = ""): void
    {
        $value = "";
        $encoding = "";
        if (preg_match("/^http/", $logo)) {
            $value = $this->encode($logo);
        } else {
            $encoding = "b";
            $logo = base64_encode($logo);
        }
        $this->types["LOGO"] = array(
            "VALUE" => $value,
            "TYPE" => $type,
            "ENCODING" => $encoding,
            "LOGO" => $logo
        );
    }
 
    public function setAgent(string $agent = ""): void
    {
        $this->types["AGENT"] = $this->escape($agent);
    }
 
    public function setOrganization(string $organization = ""): void
    {
        $organization = implode(";", $this->explodeVar($organization, ";"));
        $this->types["ORG"] = $organization;
    }
 
    // Explanatory Types
    // These types are concerned with additional explanations, such as that
    // related to informational notes or revisions specific to the vCard.
 
    public function setCategories(string $categories): void
    {
        $categories = implode(",", $this->explodeVar($categories));
        $this->types["CATEGORIES"] = $categories;
    }
 
    public function setNote(string $note = ""): void
    {
        $this->types["NOTE"] = $this->escape($note);
    }
 
    public function setProductId(string $product_id = ""): void
    {
        $this->types["PRODID"] = $this->escape($product_id);
    }
 
    public function setRevision(string $revision_date = ""): void
    {
        $this->types["REV"] = $this->escape($revision_date);
    }
 
    public function setSortString(string $string = ""): void
    {
        $this->types["SORT-STRING"] = $this->escape($string);
    }
 
    public function setSound(string $sound = "", string $type = ""): void
    {
        $value = "";
        $encoding = "";
        if (preg_match("/^http/", $sound)) {
            $value = $this->encode($sound);
        } else {
            $encoding = "b";
            $sound = base64_encode($sound);
        }
        $this->types["SOUND"] = array(
            "VALUE" => $value,
            "TYPE" => $type,
            "ENCODING" => $encoding,
            "SOUND" => $sound
        );
    }
 
    public function setUID(string $uid = "", string $type = ""): void
    {
        $this->types["UID"] = array(
            "UID" => $this->escape($uid),
            "TYPE" => $type
        );
    }
 
    public function setURL(string $uri = ""): void
    {
        $this->types["URL"] = $this->escape($uri);
    }
 
    public function setVersion(string $version = "3.0"): void
    {
        $this->types["VERSION"] = $version;
    }
 
    // Security Types
    // These types are concerned with the security of communication pathways
    // or access to the vCard.
 
    public function setClassification(string $classification = ""): void
    {
        $this->types["CLASS"] = $this->escape($classification);
    }
 
    public function setKey(string $key = "", string $type = ""): void
    {
        $encoding = "b";
        $key = base64_encode($key);
        $this->types["KEY"] = array(
            "KEY" => $key,
            "TYPE" => $type,
            "ENCODING" => $encoding
        );
    }
 
    public function getFilename(): string
    {
        if (strcmp($this->filename, "") == 0) {
            return "vcard.vcf";
        } else {
            return $this->filename;
        }
    }
 
    public function getMimetype(): string
    {
        return "text/x-vcard";
    }
}