PHPackages                             lukaspijak/vcard-parser - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing & Serialization](/categories/parsing)
4. /
5. lukaspijak/vcard-parser

ActiveLibrary[Parsing & Serialization](/categories/parsing)

lukaspijak/vcard-parser
=======================

1.0.2(1y ago)0317MITPHPPHP >=5.3.0

Since Nov 20Pushed 1y ago1 watchersCompare

[ Source](https://github.com/lukaspijak/vcard-parser)[ Packagist](https://packagist.org/packages/lukaspijak/vcard-parser)[ RSS](/packages/lukaspijak-vcard-parser/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (3)DependenciesVersions (4)Used By (0)

Nuovo/Nouveau vCard-parser is a simple vCard file parser with the focus on ease of use.

The parser was written mostly because I couldn't find one that I was satisfied with - all those that I tried either failed with real world data or were too unwieldy or inconvenient, hence this parser.

The parser can read both single and multiple vCards from a single file and with the help of PHP's magic methods and interfaces it can be written concisely. For example:

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

```

Get the number of vCards in the file

```
echo count($vCard);

```

In the single-vCard mode every element is accessible directly.

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

```

In the multiple-vCard mode the object can be used as an array to retrieve separate vCard objects for each vCard in the file.

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

```

Every vCard element is accessible as an object member by the vCard element name. Every element is an array with the data parsed out of the file. It is possible to specify an option to the vCard constructor that will let you access every element as a single value in cases where there is just one value, e.g.:

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

```

More on usage in [the wiki](https://github.com/nuovo/vCard-parser/wiki)

See also:

-  - A MIME Content-Type for Directory Information
-  - vCard MIME directory profile
-  - vCard Extensions for Instant Messaging (IM)

TODOs planned:

- Add support for non-standard ("X-...") elements;

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 83% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1106 days

Total

3

Last Release

566d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2571714?v=4)[Lukáš Piják](/maintainers/lukaspijak)[@lukaspijak](https://github.com/lukaspijak)

---

Top Contributors

[![pilsetnieks](https://avatars.githubusercontent.com/u/776876?v=4)](https://github.com/pilsetnieks "pilsetnieks (39 commits)")[![lukaspijak](https://avatars.githubusercontent.com/u/2571714?v=4)](https://github.com/lukaspijak "lukaspijak (8 commits)")

### Embed Badge

![Health badge](/badges/lukaspijak-vcard-parser/health.svg)

```
[![Health](https://phpackages.com/badges/lukaspijak-vcard-parser/health.svg)](https://phpackages.com/packages/lukaspijak-vcard-parser)
```

###  Alternatives

[mck89/peast

Peast is PHP library that generates AST for JavaScript code

19037.7M41](/packages/mck89-peast)[sauladam/shipment-tracker

Parses tracking information for several carriers, like UPS, USPS, DHL and GLS by simply scraping the data. No need for any kind of API access.

9642.0k](/packages/sauladam-shipment-tracker)[jstewmc/rtf

Read and write Rich Text Format (RTF) documents with PHP

46143.1k6](/packages/jstewmc-rtf)[moonshine/layouts-field

Field for repeating groups of fields for MoonShine

107.9k](/packages/moonshine-layouts-field)[tcds-io/php-jackson

A lightweight, flexible object serializer for PHP, inspired by FasterXML/jackson

112.9k10](/packages/tcds-io-php-jackson)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)