PHPackages                             rumenx/php-vcard - 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. [Utility & Helpers](/categories/utility)
4. /
5. rumenx/php-vcard

ActiveLibrary[Utility & Helpers](/categories/utility)

rumenx/php-vcard
================

Framework-agnostic PHP package to generate vCard files, with Laravel and Symfony support.

v1.0.2(7mo ago)51.5k↓25%1MITPHPPHP ^8.2CI passing

Since Jun 7Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/RumenDamyanov/php-vcard)[ Packagist](https://packagist.org/packages/rumenx/php-vcard)[ Docs](https://github.com/RumenDamyanov/php-vcard)[ GitHub Sponsors](https://github.com/sponsors/RumenDamyanov)[ RSS](/packages/rumenx-php-vcard/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (5)Used By (1)

php-vcard
=========

[](#php-vcard)

[![Build Status](https://github.com/RumenDamyanov/php-vcard/actions/workflows/ci.yml/badge.svg)](https://github.com/RumenDamyanov/php-vcard/actions)[![codecov](https://camo.githubusercontent.com/4ae17a06ed40b569cf46f6ea48d648c6c2ecaf36229be0021663638e95535962/68747470733a2f2f636f6465636f762e696f2f67682f52756d656e44616d79616e6f762f7068702d76636172642f67726170682f62616467652e7376673f746f6b656e3d574b6761446e707a4a43)](https://codecov.io/gh/RumenDamyanov/php-vcard)

A framework-agnostic PHP package to generate vCard files (compatible with iPhone, Android, Gmail, iCloud, etc.), with out-of-the-box support for Laravel and Symfony.

Features
--------

[](#features)

- Generate vCard files as static files or HTTP responses
- Compatible with major contact managers (iOS, Android, Gmail, iCloud, etc.)
- Simple, extensible API
- 100% test coverage with Pest
- MIT License

Installation
------------

[](#installation)

```
composer require rumenx/php-vcard
```

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

```
use Rumenx\PhpVcard\VCard;

$vcard = new VCard();
$vcard->addName('Jon', 'Snow');
$vcard->addEmail('jon@example.com');
$vcard->addPhone('+1234567890');
$vcard->addAddress('123 Main St', 'City', 'State', '12345', 'Country');

// Save to file
$vcard->saveToFile('jon_snow.vcf');

// Or get as string
$content = $vcard->toString();
```

### Laravel Example

[](#laravel-example)

```
use Rumenx\PhpVcard\VCard;

Route::get('/vcard', function () {
    $vcard = new VCard();
    $vcard->addName('Arya', 'Stark');
    $vcard->addEmail('arya@example.com');
    $vcard->addPhone('+1987654321');

    return response($vcard->toString(), 200, [
        'Content-Type' => 'text/vcard',
        'Content-Disposition' => 'attachment; filename="arya_stark.vcf"',
    ]);
});
```

### Symfony Example

[](#symfony-example)

```
use Rumenx\PhpVcard\VCard;
use Symfony\Component\HttpFoundation\Response;

// ...
$vcard = new VCard();
$vcard->addName('Alice', 'Brown');
$vcard->addEmail('alice@example.com');
$vcard->addPhone('+1122334455');
$response = new Response(
    $vcard->toString(),
    200,
    [
        'Content-Type' => 'text/vcard',
        'Content-Disposition' => 'attachment; filename="alice_brown.vcf"',
    ]
);
```

Framework Integration
---------------------

[](#framework-integration)

This package follows a **simple, framework-agnostic approach** by design. Unlike packages that require special adapters, service providers, or complex integrations, php-vcard works out-of-the-box with any PHP framework or plain PHP project.

**Why no special adapters?**

- **Simplicity**: Just instantiate `new VCard()` - no magic, no hidden complexity
- **Universal compatibility**: Works with Laravel, Symfony, CodeIgniter, or any PHP framework
- **Easy debugging**: No framework-specific layers to troubleshoot
- **Minimal maintenance**: No need to maintain separate adapters for different frameworks
- **Standard PHP**: Uses only basic PHP features (strings, arrays, file operations)

This approach makes the package more reliable, easier to understand, and ensures it will continue working across different framework versions without requiring updates.

Testing
-------

[](#testing)

```
# Run tests
composer test

# Run tests with coverage
composer test-coverage

# Generate HTML coverage report
composer test-coverage-html
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to this project.

Security
--------

[](#security)

For security vulnerabilities, please see our [Security Policy](SECURITY.md).

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for release history and changes.

Support
-------

[](#support)

If you find this package useful, please consider:

- ⭐ Starring the repository
- 💖 [Sponsoring the project](FUNDING.md)
- 🐛 Reporting issues
- 📖 Contributing to documentation

License
-------

[](#license)

This project is licensed under the [MIT License](LICENSE.md).

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance75

Regular maintenance activity

Popularity25

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.4% 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 ~54 days

Total

3

Last Release

236d ago

PHP version history (3 changes)v1.0.0PHP ^8.3 || ^8.4

v1.0.1PHP >=8.3

v1.0.2PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/48dce3e6200e787e75a4a14e0d31738d112261fe0877f15f74d3fb2c2a626229?d=identicon)[RumenX](/maintainers/RumenX)

---

Top Contributors

[![RumenDamyanov](https://avatars.githubusercontent.com/u/1458253?v=4)](https://github.com/RumenDamyanov "RumenDamyanov (24 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")

---

Tags

addressbookcontactslaravelphpsymfonyvcardphpsymfonylaravelvCardcontactsaddressbook

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/rumenx-php-vcard/health.svg)

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

###  Alternatives

[rumenx/php-feed

Framework-agnostic PHP Feed generator for Laravel, Symfony, and more.

3652.3k](/packages/rumenx-php-feed)[llm-agents/agents

LLM Agents PHP SDK - Autonomous Language Model Agents for PHP

16410.9k9](/packages/llm-agents-agents)[brexis/laravel-workflow

Integerate Symfony Workflow component into Laravel.

283125.6k](/packages/brexis-laravel-workflow)[astrotomic/laravel-vcard

A fluent builder class for vCard files.

5330.0k](/packages/astrotomic-laravel-vcard)[rumenx/php-seo

AI-powered, framework-agnostic PHP package for automated SEO optimization. Intelligently generates meta tags, titles, descriptions, and alt texts using configurable AI providers or manual patterns.

102.0k](/packages/rumenx-php-seo)[arnolem/tailwindphp

TailwindPHP - use Tailwind CSS in your PHP projects (without npm)

131.1k](/packages/arnolem-tailwindphp)

PHPackages © 2026

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