dastanaron/vcard

这个 VCard PHP 类可以生成包含一些数据的 vCard。这是基于流行的库 https://github.com/jeroendesloovere/vcard 的分支。

1.7.3.4 2020-12-23 07:35 UTC

README

Latest Stable Version License donate

这个 VCard PHP 库可以生成包含一些数据的 vCard。当使用 iOS 设备且版本小于 iOS 8 时,它会导出为 .ics 文件,因为 iOS 设备不支持默认的 .vcf 文件。

注意:我们正在开发一个全新的版本,以支持 vCard 版本 4.0,代码质量极高。请查看新版本 检查新版本

用法

安装

composer require dastanaron/vcard

这将使用 Composer 安装 vcard 的最新版本

测试

  1. 克隆此项目
  2. cd 到项目文件夹
  3. 运行命令
./run_test.sh

示例

查看所有示例 或检查 VCard 类

解析示例

解析器可以传入一个 VCard 字符串,如下所示

// load VCardParser classes
use Dastanaron\VCard\VCardParser;

$parser = new VCardParser($vcardString);
echo $parser->getCardAtIndex(0)->fullname; // Prints the full name.

或者通过使用一个带文件名的工厂方法

$parser = VCardParser::parseFromFile('path/to/file.vcf');
echo $parser->getCardAtIndex(0)->fullname; // Prints the full name.

查看解析示例 或检查 VCardParser 类

框架支持

我创建了一个 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 一起工作的更多信息。

致谢

许可

该模块在 MIT 许可下发布。简而言之,此许可证允许您做任何事情,只要版权声明仍然存在。