nuovo / vcard-parser Goto Github PK

    $vcard -> url 

Array(
 '0' => Array(
                '0' => URL  
          )
);

 '0' => Array(
                'Value' => URL  
          )
);

VERSION:3.0
NICKNAME:alu
EMAIL;TYPE=INTERNET;TYPE=HOME;TYPE=PREF:[email protected]
X-AFTERLOGIC-USE-FRIENDLY-NAME:1
FN:abu
PRODID:-//Afterlogic//6.5.x//EN
UID:b6a17e3a-3b0a-4f8e-9c4d-cec6d570097f
N:apu;asu;;;;
END:VCARD
])
01/11/2012 15:26:20 [ 3524] [DEBUG] [[email protected]] [android1334515447810] BackendCardDAV->_ParseVCardToAS(vCard fileas [abu])
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O      <Add>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O       <ServerEntryId>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O       b6a17e3a-3b0a-4f8e-9c4d-cec6d570097f
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O       </ServerEntryId>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O       <Data>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        <POOMCONTACTS:FileAs>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        abu
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        </POOMCONTACTS:FileAs>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        <POOMCONTACTS:FirstName>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        asu
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        </POOMCONTACTS:FirstName>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        <POOMCONTACTS:LastName>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        apu
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        </POOMCONTACTS:LastName>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        <POOMCONTACTS2:NickName>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        alu
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O        </POOMCONTACTS2:NickName>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O       </Data>
01/11/2012 15:26:20 [ 3524] [WBXML] [[email protected]] [android1334515447810] O      </Add>

@@ -50,11 +50,13 @@

        private static $Spec_ElementTypes = array(
            'email' => array('internet', 'x400', 'pref'),
            'adr' => array('dom', 'intl', 'postal', 'parcel', 'home', 'work', 'pref'),
            'label' => array('dom', 'intl', 'postal', 'parcel', 'home', 'work', 'pref'),
-           'tel' => array('home', 'msg', 'work', 'pref', 'voice', 'fax', 'cell', 'video', 'pager', 'bbs', 'modem', 'car', 'isdn', 'pcs')
+           'tel' => array('home', 'msg', 'work', 'pref', 'voice', 'fax', 'cell', 'video', 'pager', 'bbs', 'modem', 'car', 'isdn', 'pcs'),
+           'url' => array('work', 'home'), // not per RFC but may be present in practice
+           'impp' => array('personal','business','home','work','mobile','pref') // http://tools.ietf.org/html/rfc4770
        );

        private static $Spec_FileElements = array('photo', 'logo', 'sound');

        /**
@@ -138,16 +140,23 @@
                    $this -> Data[] = new vCard(false, $SinglevCardRawData);
                }
            }
            else
            {
+               // Protect the BASE64 final = sign (detected by the line beginning with whitespace), otherwise the next replace will get rid of it
+               $this -> RawData = preg_replace('/(\n\s.+)=(\n)/', '$1-base64=-$2', $this -> RawData);
+
                // Joining multiple lines that are split with a hard wrap and indicated by an equals sign at the end of line
+               // i.e. quoted-printable-encoded values in v2.1 vCards
                $this -> RawData = str_replace("=\n", '', $this -> RawData);

                // Joining multiple lines that are split with a soft wrap (space or tab on the beginning of the next line
                $this -> RawData = str_replace(array("\n ", "\n\t"), '-wrap-', $this -> RawData);

+               // Restore the BASE64 =
+               $this -> RawData = str_replace("-base64=-\n", "=\n", $this -> RawData);
+
                $Lines = explode("\n", $this -> RawData);

                foreach ($Lines as $Line)
                {
                    // Lines without colons are skipped because, most likely, they contain no data.
@@ -160,10 +169,11 @@
                    //  value is just the value
                    list($Key, $Value) = explode(':', $Line, 2);

                    // Key is transformed to lowercase because, even though the element and parameter names are written in uppercase,
                    //  it is quite possible that they will be in lower- or mixed case.
+                   // The key is trimmed to allow for non-significant WSP characters as allowed by v2.1
                    $Key = strtolower(trim(self::Unescape($Key)));

                    // These two lines can be skipped as they aren't necessary at all.
                    if ($Key == 'begin' || $Key == 'end')
                    {
@@ -183,10 +193,13 @@
                    else
                    {
                        $Value = str_replace('-wrap-', '', $Value);
                    }

+                   // The value is trimmed to allow for non-significant WSP characters as allowed by v2.1
+                   // (This might remove white space which a v3.0 parser is meant to retain)
+                   // WARNING! unescaping ; characters at this point causes the ParseStructuredValue later to parse the values wrongly!
                    $Value = trim(self::Unescape($Value));
                    $Type = array();

                    // Here additional parameters are parsed
                    $KeyParts = explode(';', $Key);
@@ -201,20 +214,22 @@
                        {
                            switch ($ParamKey)
                            {
                                case 'encoding':
                                    $Encoding = $ParamValue;
-                                   if ($ParamValue == 'b')
+                                   // Allow for both v3.0 B and v2.1 BASE64 encoding parameter values
+                                   //if ($ParamValue == 'b')
+                                   if (in_array($ParamValue, array('b', 'base64')))
                                    {
                                        //$Value = base64_decode($Value);
                                    }
-                                   elseif ($ParamValue == 'quoted-printable')
+                                   elseif ($ParamValue == 'quoted-printable') // v2.1
                                    {
                                        $Value = quoted_printable_decode($Value);
                                    }
                                    break;
-                               case 'charset':
+                               case 'charset': // v2.1
                                    if ($ParamValue != 'utf-8' && $ParamValue != 'utf8')
                                    {
                                        $Value = mb_convert_encoding($Value, 'UTF-8', $ParamValue);
                                    }
                                    break;
@@ -336,11 +351,13 @@
            }

            if (is_writable($TargetPath) || (!file_exists($TargetPath) && is_writable(dirname($TargetPath))))
            {
                $RawContent = $this -> Data[$Key][$Index]['Value'];
-               if (isset($this -> Data[$Key][$Index]['Encoding']) && $this -> Data[$Key][$Index]['Encoding'] == 'b')
+               // Allow for both v3.0 B and v2.1 BASE64 encoding parameter values
+               //if (isset($this -> Data[$Key][$Index]['Encoding']) && $this -> Data[$Key][$Index]['Encoding'] == 'b')
+               if (isset($this -> Data[$Key][$Index]['Encoding']) && (in_array($this -> Data[$Key][$Index]['Encoding'], array('b', 'base64'))) )
                {
                    $RawContent = base64_decode($RawContent);
                }
                $Status = file_put_contents($TargetPath, $RawContent);
                return (bool)$Status;
@@ -493,10 +510,12 @@
         * @return string Resulting text.
         */
        private static function Unescape($Text)
        {
            return str_replace(array('\:', '\;', '\,', "\n"), array(':', ';', ',', ''), $Text);
+           // The line above removes encoded newlines ("\n") rather than converting them back to CRLF character sequences!
+           // "\N" should be treated in the same way as "\n"
        }

        /**
         * Separates the various parts of a structured value according to the spec.
         *
@@ -582,11 +601,13 @@
                else
                {
                    switch ($Parameter[0])
                    {
                        case 'encoding':
-                           if (in_array($Parameter[1], array('quoted-printable', 'b')))
+                           // Allow for both v3.0 B and v2.1 BASE64 encoding parameter values
+                           //if (in_array($Parameter[1], array('quoted-printable', 'b')))
+                           if (in_array($Parameter[1], array('quoted-printable', 'b', 'base64')))
                            {
                                $Result['encoding'] = $Parameter[1];
                            }
                            break;
                        case 'charset':

Array
(
    [0] => Array
        (
            [LastName] => 
            [FirstName] => 
            [AdditionalNames] => 
            [Prefixes] => 
            [Suffixes] => 
        )

)
Array
(
    [0] => Array
        (
            [Value] => 1-800-MY-APPLE
            [Type] => Array
                (
                    [0] => main
                    [1] => pref
                )

        )

)

 item1.ADR;type=WORK;type=pref:;;1 Infinite Loop;Cupertino;CA;95014;United States
 item1.X-ABADR:us