dastanaron / vcard
这个 VCard PHP 类可以生成包含一些数据的 vCard。这是基于流行的库 https://github.com/jeroendesloovere/vcard 的分支。
1.7.3.4
2020-12-23 07:35 UTC
Requires
- php: >=5.5
- behat/transliterator: ~1.0
Requires (Dev)
- phpunit/phpunit: 4.6.*
README
这个 VCard PHP 库可以生成包含一些数据的 vCard。当使用 iOS 设备且版本小于 iOS 8 时,它会导出为 .ics 文件,因为 iOS 设备不支持默认的 .vcf 文件。
注意:我们正在开发一个全新的版本,以支持 vCard 版本 4.0,代码质量极高。请查看新版本 检查新版本
用法
安装
composer require dastanaron/vcard
这将使用 Composer 安装 vcard 的最新版本
测试
- 克隆此项目
cd
到项目文件夹- 运行命令
./run_test.sh
示例
解析示例
解析器可以传入一个 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 许可下发布。简而言之,此许可证允许您做任何事情,只要版权声明仍然存在。