PHPackages                             jaredhowland/contacts - 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. jaredhowland/contacts

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

jaredhowland/contacts
=====================

📇 PHP library for address book contacts (make vCards for contacts)

v6.0.0(2y ago)64.0k↓50%1MITPHPPHP ^8.0

Since Oct 19Pushed 2y ago2 watchersCompare

[ Source](https://github.com/jaredhowland/contacts)[ Packagist](https://packagist.org/packages/jaredhowland/contacts)[ Docs](http://github.com/jaredhowland/contacts)[ Fund](https://paypal.me/jaredhowland)[ RSS](/packages/jaredhowland-contacts/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (31)Used By (0)

[![Scrutinizer](https://camo.githubusercontent.com/a573a53cf0920767a49c5be2213b60bdbb234afdfe4dcfa502a53781b1eceae7/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6a61726564686f776c616e642f636f6e74616374732f6d61696e2e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/a573a53cf0920767a49c5be2213b60bdbb234afdfe4dcfa502a53781b1eceae7/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6a61726564686f776c616e642f636f6e74616374732f6d61696e2e7376673f7374796c653d666c61742d737175617265) [![Build](https://camo.githubusercontent.com/69e93ecdda77da250b718fb24ed95c11feaeb159a20308ab932c75da93d59b8a/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f6275696c642f672f6a61726564686f776c616e642f636f6e74616374732f6d61696e2e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/69e93ecdda77da250b718fb24ed95c11feaeb159a20308ab932c75da93d59b8a/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f6275696c642f672f6a61726564686f776c616e642f636f6e74616374732f6d61696e2e7376673f7374796c653d666c61742d737175617265) [![StyleCI](https://camo.githubusercontent.com/9868eea224f3f5f2f059d118dbdf06a2b36e2bfa33c7b436a3fd1643571a4446/68747470733a2f2f7374796c6563692e696f2f7265706f732f37313330343236352f736869656c643f6272616e63683d6d61696e)](https://camo.githubusercontent.com/9868eea224f3f5f2f059d118dbdf06a2b36e2bfa33c7b436a3fd1643571a4446/68747470733a2f2f7374796c6563692e696f2f7265706f732f37313330343236352f736869656c643f6272616e63683d6d61696e) [![Packagist-dl](https://camo.githubusercontent.com/480da4caca58a57963fcc0852d5f5b6380912721ba9414fdf7ca532ac89bf80e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a61726564686f776c616e642f636f6e74616374732e7376673f7374796c653d666c61742d737175617265266c6162656c3d696e7374616c6c7326636f6c6f723d253233393236356266)](https://camo.githubusercontent.com/480da4caca58a57963fcc0852d5f5b6380912721ba9414fdf7ca532ac89bf80e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a61726564686f776c616e642f636f6e74616374732e7376673f7374796c653d666c61742d737175617265266c6162656c3d696e7374616c6c7326636f6c6f723d253233393236356266) [![Packagist](https://camo.githubusercontent.com/cfb57d48c1936ba7995f721922d0324fce7edc3970abddda400994afd3f8df19/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a61726564686f776c616e642f636f6e74616374732e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/cfb57d48c1936ba7995f721922d0324fce7edc3970abddda400994afd3f8df19/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a61726564686f776c616e642f636f6e74616374732e7376673f7374796c653d666c61742d737175617265) [![MIT License](https://camo.githubusercontent.com/a7e65aee57b11d28e4caff8b945729a66be0bb663f7f93bd24c5aa65699f148e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/a7e65aee57b11d28e4caff8b945729a66be0bb663f7f93bd24c5aa65699f148e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)

Contacts
--------

[](#contacts)

Contacts is a small PHP library to create files containing address book information for people or organizations. Currently, [vCard 3.0](https://tools.ietf.org/html/rfc2426) is the only supported export format.

Features
--------

[](#features)

- [vCard 3.0](https://tools.ietf.org/html/rfc2426) Compatibility:
    - Generates vCards that should be compatible with all applications that use vCards
    - Includes fields that are unique to the iOS and macOS contacts application (`Supervisor`, `Anniversary`, `Spouse`, `Child`)
- Flexible: future implementations will include other formats commonly used to store contact information—other vCard formats, microformats, Google contacts format, `.csv` format, etc.
- Method chaining for constructing contact information in a fluid interface
- The method argument order typically comes directly from the [standard](https://tools.ietf.org/html/rfc2426) itself

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

[](#installation)

Contacts is available as a [Composer](https://getcomposer.org) [package](http://packagist.org/):

1. If needed, install [Composer](https://getcomposer.org)
2. Add the following to your `composer.json` file

```
"require": {
   "jaredhowland/contacts": "~6.0"
}
```

Usage
-----

[](#usage)

### Input

[](#input)

This is an extensive example. The code is well documented and you should get all the hints needed for using it in an IDE. Most of the time, you will only need a fraction of these fields to create a vCard:

```