README

Nuovo/Nouveau vCard-parser 是一个简单易用的 vCard 文件解析器。

这个解析器主要是因为找不到满意的解析器而编写的——我所尝试的所有解析器要么在真实数据上失败，要么太难以操作或使用不便，因此才有了这个解析器。

该解析器可以从单个文件中读取单个和多个 vCard，并且借助 PHP 的魔术方法和接口，它可以简洁地编写。例如

include('vCard.php');
$vCard = new vCard('Example3.0.vcf');

获取文件中 vCard 的数量

echo count($vCard);

在单 vCard 模式下，每个元素都可以直接访问。

if (count($vCard) == 1)
{
    print_r($vCard -> n);
    print_r($vCard -> tel);
}

在多 vCard 模式下，可以将对象用作数组来检索文件中每个 vCard 的单独 vCard 对象。

else
{
    foreach ($vCard as $vCardPart)
    {
        print_r($vCardPart -> n);
        print_r($vCardPart -> tel);
    }
}

每个 vCard 元素都可以通过 vCard 元素名称作为对象成员访问。每个元素都是一个包含从文件中解析出来的数据的数组。可以通过向 vCard 构造函数指定一个选项，以便在只有一个值的情况下将每个元素作为单个值访问，例如

$vCard = new vCard('Example3.0.vcf', false, array('Collapse' => true));

更多使用方法请参阅维基百科

另请参阅

计划中的 TODO

lukaspijak / vcard-parser