PHPackages                             bright/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. bright/vcard

Abandoned → vcard-phpLibrary[Utility & Helpers](/categories/utility)

bright/vcard
============

Generate vCard files for quick contact import.

v1.0.1(7mo ago)0174MITPHPPHP ^8.1CI passing

Since Nov 9Pushed 4mo agoCompare

[ Source](https://github.com/GoBrightApps/vcard-php)[ Packagist](https://packagist.org/packages/bright/vcard)[ RSS](/packages/bright-vcard/feed)WikiDiscussions main Synced 4mo ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

VCard Generator
===============

[](#vcard-generator)

A lightweight PHP package for generating `.vcf` (vCard) files — compatible with most contact applications.

Includes convenient helpers for building vCards from models or plain data arrays.

⚙️ Requirements
---------------

[](#️-requirements)

- PHP 8.1+

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

[](#installation)

Install via Composer:

```
composer require bright/vcard-php
```

Quick Usage
-----------

[](#quick-usage)

### Create a simple vCard

[](#create-a-simple-vcard)

```
use Bright\VCard\VCard;

$vcard = VCard::make()
    ->addName('Doe', 'John')
    ->addEmail('john@example.com', 'WORK')
    ->addPhoneNumber('+1 555-1234', 'WORK')
    ->addCompany('Bright')
    ->addJobtitle('Developer')
    ->addAddress('', '', '123 Main St', 'New York', '', '10001', 'United States')
    ->addURL('https://linkedin.com/in/johndoe', 'LinkedIn')
    ->addNote('Software Developer at Bright')
    ->addFilename('John Doe');

$file = $vcard->getFilename() . '.vcf';
$vcard->save(); // Saves to disk
```

File Output
-----------

[](#file-output)

By default, `.vcf` files are saved in the current working directory.
You can change the save directory:

```
$vcard->setSavePath(__DIR__ . '/exports/');
$vcard->save();
```

Output response
---------------

[](#output-response)

```
use Bright\VCard\VCard;

$vcard = VCard::make()
    ->addName('Doe', 'John')
    ->addEmail('john@example.com', 'WORK')
    ->addPhoneNumber('+1 555-1234', 'WORK')
    ->addCompany('Bright')
    ->addFilename('John Doe');

// Build the VCard
$output = $vcard->buildVCard();

// Set appropriate headers
$headers = $vcard->getHeaders(true);

// Output headers manually (instead of Laravel's response helper)
foreach ($headers as $key => $value) {
    header("$key: $value");
}

// Send the VCard data as the response
http_response_code(200);
echo $output;
exit;
```

Testing
-------

[](#testing)

To run the test suite (powered by [Pest](https://pestphp.com)):

```
composer install
./vendor/bin/pest
```

📝 License
---------

[](#-license)

MIT License © [Bright](https://bright.it)

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance68

Regular maintenance activity

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.2% 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 ~0 days

Total

2

Last Release

237d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1f8ebeaa5852b0579934881dcb0e479ab2c970960774be27e224db9ee005cffe?d=identicon)[saeedhosan](/maintainers/saeedhosan)

---

Top Contributors

[![saeedhosan](https://avatars.githubusercontent.com/u/78552486?v=4)](https://github.com/saeedhosan "saeedhosan (15 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")

###  Code Quality

TestsPest

### Embed Badge

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

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

###  Alternatives

[phasync/phasync

phasync asyncio library for PHP, providing seamless and efficient coroutines via PHP fibers

2463.2k4](/packages/phasync-phasync)[ehaerer/paste-reference

Paste Reference - offers the option to paste references instead of copies for content elements in TYPO3

19367.1k](/packages/ehaerer-paste-reference)[haringsrob/livewire-datepicker

A standalone livewire datepicker component without dependencies

4118.1k](/packages/haringsrob-livewire-datepicker)

PHPackages © 2026

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