abduns/laravel-vcard

Laravel bridge for the abduns/vcard generator.

v1.1.5 2026-05-17 12:47 UTC

Requires

• php: ^8.2
• abduns/vcard: ^1.0 || dev-main
• illuminate/support: ^12.0|^13.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.64
• larastan/larastan: ^3.0
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• phpstan/phpstan: ^2.0

MIT

• Abduns

• laravel
• vCard
• vcf

README

Laravel bridge for the abduns/vcard generator.

Features

• Modern PHP support
• Lightweight and fast
• Typed API
• Laravel Facade
• Response macros for .vcf downloads
• Standards-oriented

Installation

composer require abduns/laravel-vcard

Quick Start

use Dunn\VCard\Laravel\Facades\VCard;

return response()->vcard(
    VCard::make()
        ->addName('Doe', 'John')
        ->addEmail('[e-mail]', 'work')
        ->addPhoneNumber('[phone]', 'cell'),
    'john_doe.vcf'
);

Why This Package?

• Existing solutions are outdated
• Missing modern PHP features
• Poor developer experience
• No standards compliance
• Too framework-coupled

This package focuses on simplicity, interoperability, and modern developer ergonomics for generating .vcf files natively in your Laravel application.

Usage

Basic Usage

use Dunn\VCard\Laravel\Facades\VCard;

$vcf = VCard::make()
    ->addName('Doe', 'John')
    ->addEmail('[e-mail]', 'work')
    ->addPhoneNumber('[phone]', 'cell')
    ->addUrl('https://johndoe.com')
    ->build();

Advanced Usage

public function download(User $user)
{
    $vcard = VCard::make()
        ->addName($user->last_name, $user->first_name)
        ->addEmail($user->email)
        ->addPhoneNumber($user->phone, 'cell')
        ->addUid('urn:uuid:' . $user->uuid);

    return response()->vcard($vcard, "{$user->slug}.vcf");
}

Standards / Specifications

• RFC 6350
• RFC 6474
• RFC 6715
• RFC 8605
• RFC 9554
• RFC 9555

References:

• https://www.iana.org/assignments/vcard-elements/vcard-elements.xhtml

Supported Features

Feature	Support
Facade	✅
Response Macros	✅

Compatibility

Platform	Supported
PHP 8.2+	✅
Laravel 12.0+	✅

Design Goals

• Developer experience first
• Predictable APIs
• Minimal dependencies
• Strong typing
• Native Laravel integration

Architecture

• facades
• service providers
• macroable responses

Performance

Operation	Time
Generate vCard	< 1ms

Testing

composer test

Roadmap

• Artisan command for generating test vCards
• CardDAV response helpers
• Livewire component for vCard preview

Contributing

Contributions, issues, and discussions are welcome.

Security

If you discover security issues, please report them responsibly.

License

MIT