README

这是一个 FullContact API 的 PHP 辅助工具 - http://www.fullcontact.com/

它仿照了 Twilio PHP 辅助库，因为我认为它做得很好，考虑得也很周到。这不是官方的，但应该可以正常工作，除了下面的 TODO 列表中的不完整项。

最初是从 https://github.com/caseysoftware/fullcontact-api-php 分支出来的，但我不想等待拉取请求，所以我创建了一个单独的包

这是 v0.9.2 版。-- TM

要求

这假设你已经安装了 cURL 以及相应的 php-curl 接口。它可以扩展以支持其他 HTTP 传输工具，但我有点懒。

安装

composer require matula/fullcontact-api-php 

使用版本 v0.9.2。

入门

您必须有一个 FullContact 账户。然后复制 creds-dist.php 文件到 creds.php 并填写 API 密钥。然后您应该能够直接运行 /examples 目录中的任何脚本。

代码本身很简单。您使用 API 密钥初始化选定的对象，然后继续操作

$this->name = new Services_FullContact_Name($apikey);

测试

这是使用基本的 PHPUnit 配置设置的。我恰好使用了 3.7.8 版，但这应该没有影响。从项目的根目录，您应该可以使用以下命令执行测试

phpunit tests/

待办事项

此库尚未完成，以下是活跃的待办事项列表。

• 对于 Person 资源
• 实现通过电子邮件和 emailMD5 查找
• 实现输出样式（仅通过电子邮件查找）
• 实现通过电话查找
• 实现非 US/Canada 电话号码的国家代码
• 实现通过 Twitter 查找
• 实现通过 Facebook 用户名查找
• 实现通过 vCard 查找
• 实现基于队列的处理和回调
• 实现 webhookUrl 和 webhookId 以进行异步处理
• 实现 css 和 prettyPrint 输出
• 实现增强查找检索
• 对于 Name 资源
• 实现使用大小写进行归一化
• 实现使用电子邮件或用户名（使用大小写）进行推导
• 实现使用大小写进行相似度比较
• 实现使用 name, givenName, familyName, 和两者（givenName 和 familyName）进行统计
• 实现使用大小写的解析器
• 对于 Location 资源
• 实现使用 includeZeroPopulation 和大小写进行归一化
• 实现使用 includeZeroPopulation 和大小写进行丰富化
• 对于 Icon 资源
• 实现获取所有可用图标的方式
• 实现使用大小写和类型检索图标
• 实现 CardShark 资源
• 实现检测可抛弃电子邮件地址
• 实现检索账户统计信息
• 更新库以向后兼容先前官方版本
• 更新测试以使用 Mocks 而不是实时 API 呼叫，因为它可能会耗尽您的账户积分。哎。

许可

所有包含的代码均遵循Apache许可证。

版权所有（C）2013，FullContact及贡献者

根据Apache许可证2.0版（以下简称“许可证”）；除非适用法律要求或经书面同意，否则不得使用此文件，除非遵守许可证。您可以在以下地址获得许可证副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则在许可证下分发的软件按“原样”分发，不提供任何形式的明示或暗示保证。有关许可证下权限和限制的具体语言，请参阅许可证。