README

这个VCard PHP类可以生成包含一些数据的vCard。当在iOS设备（iOS 8以下版本）上使用时，它将导出为.ics文件，因为iOS设备不支持默认的.vcf文件。

使用方法

安装

{
    "require": {
        "jeroendesloovere/vcard": "1.2.*"
    }
}

当使用Composer时，将上述内容添加到您的composer.json文件中。

示例

use JeroenDesloovere\VCard\VCard;

// define vcard
$vcard = new VCard();

// define variables
$lastname = 'Desloovere';
$firstname = 'Jeroen';
$additional = '';
$prefix = '';
$suffix = '';

// add personal data
$vcard->addName($lastname, $firstname, $additional, $prefix, $suffix);

// add work data
$vcard->addCompany('Siesqo');
$vcard->addJobtitle('Web Developer');
$vcard->addEmail('info@jeroendesloovere.be');
$vcard->addPhoneNumber(1234121212, 'PREF;WORK');
$vcard->addPhoneNumber(123456789, 'WORK');
$vcard->addAddress(null, null, 'street', 'worktown', null, 'workpostcode', 'Belgium');
$vcard->addURL('http://www.jeroendesloovere.be');

$vcard->addPhoto(__DIR__ . '/landscape.jpeg');

// return vcard as a string
//return $vcard->getOutput();

// return vcard as a download
return $vcard->download();

查看所有示例或查看VCard类。

框架支持

我创建了一个Symfony Bundle: VCard Bundle

例如在Laravel中的使用

return Response::make(
    $this->vcard->getOutput(),
    200,
    $this->vcard->getHeaders(true)
);

文档

类有良好的内部文档。如果您使用了一个不错的IDE，您会看到每个方法都有PHPDoc文档。

贡献

贡献是欢迎的，并将得到充分的认可。

拉取请求

添加或更新代码

• 编码语法 - 请保持代码语法与包的其他部分一致。
• 添加单元测试！ - 如果您的补丁没有测试，则不会被接受。
• 记录任何行为变化 - 确保README和其他相关文档保持最新。
• 考虑我们的发布周期 - 我们尽量遵循semver。随机破坏公共API不是选项。
• 创建主题分支 - 不要要求我们从您的master分支拉取。
• 每个特性一个拉取请求 - 如果您想做更多的事情，请发送多个拉取请求。
• 发送连贯的历史记录 - 确保您的拉取请求中的每个单独提交都是有意义的。如果您在开发过程中不得不进行多个中间提交，请在提交之前将其压缩。

问题

用于报告错误或进行代码讨论。

有关如何在help.github.com上使用GitHub的更多信息。

致谢

• Jeroen Desloovere
• 所有贡献者

许可

该模块受MIT许可。简而言之，此许可证允许您做任何事，只要保留版权声明。