PHP Classes

File: readme.md

Recommend this page to a friend!
  Classes of Stefan Kientzler   PHP vCard Library   readme.md   Download  
File: readme.md
Role: Documentation
Content type: text/markdown
Description: readme
Class: PHP vCard Library
Import and export contact lists in vCard format
Author: By
Last change: scrutinizer fixes
win test
Date: 1 year ago
Size: 4,115 bytes
 

Contents

Class file image Download

PHP vCard Library: Import and export contacts in vCard format

Latest Stable Version License Donate Minimum PHP Version Scrutinizer Code Quality

This package can be used to import and export contact lists in vCard format.

It can create a new contact list from scratch and export it in vCard format - .vcf - compliant with the version 3.0 of the format specification (RFC 2426).

The package can also import an existing VCF file and makes it available to the PHP applications as an iterator that returns the details of each contact that was found in the vCard file. The package supports vCard format version 2.1 and 3.0.

New in Version 1.1.0

  • Support of multiple homepages per contact
  • new method `VCard::listContacts() : array`

Installation

You can download the Latest release version from PHPClasses.org

Usage

Import VCF

    // create object and read file
    $oVCard = new VCard();
    $iContactCount = $oVCard->read($strFilename);
    for ($i = 0; $i < $iContactCount; $i++) {
        // iterate to importetd contacts
        $oContact = $oVCard->getContact($i);
        $strName = $oContact->getName();
        // ... read more properties
        
        // iterating through all addresses
        $iCount = $oContact->getAddressCount();
        for ($j = 0; $j < $iCount; $j++) {
            $oAddress = $oContact->getAddress($j);
            $strStr = $oAddress->getStr();
            // ... read more properties
        }

        // phonenumbers
        $iCount = $oContact->getPhoneCount();
        for ($j = 0; $j < $iCount; $j++) {
            $aPhone = $oContact->getPhone($j);
            $strType = $aPhone['strType'];
            $strPhone = $aPhone['strPhone'];
        }

        $iCount = $oContact->getEMailCount();
        for ($j = 0; $j < $iCount; $j++) {
            $strMail = $oContact->getEMail($j);
        }
    }

> Note: > If data to be exported comes from a database/table with collation latinX_yyyyy, the character > encoding detection order from PHP may have to be set with > mb_detect_order('UTF-8, Windwos-1252, ISO-8859-XX') before using the class (replace X,y to fit your encoding).

Export VCF

    // create object
    $oVCard = new VCard();

    // just create new contact
    $oContact = new VCardContact();
    $oContact->setName('von Flake', 'Wiki');
    $oContact->setOrganisation('Company 4711');

    // HOME address
    $oAddress = new VCardAddress();
    $oAddress->setType(VCard::HOME);
    $oAddress->setStr('Bärenweg. 4');
    // ... set more properties of oAddress
    $oContact->addAddress($oAddress, true);

    // WORK address
    $oAddress = new VCardAddress();
    $oAddress->setType('WORK');
    $oAddress->setStr('Companystr. 8');
    // ... set more properties of oAddress
    $oContact->addAddress($oAddress, false);

    // phones
    $oContact->addPhone('01234 5678', VCard::HOME, false);
    $oContact->addPhone('0123 89765456', VCard::CELL, true);
    $oContact->addPhone('01234 98356', VCard::WORK, false);
    
    // e-mails
    $oContact->addEMail('private@web.de', true);
    $oContact->addEMail('president@club.de', false);
    $oContact->addEMail('work@company.de', false);
    
    // insert contact
    $oVCard->addContact($oContact);
    
    // ... may continue with further contacts

    // and write to file
    $oVCard->write('test.vcf', false);