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));

有关使用方法的更多信息，请参阅wiki

另请参阅

计划中的TODO

worksection / vcard