README

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

它基于 Twilio PHP 辅助库，因为我认为它做得很好，并且经过深思熟虑。这不是官方的，但应该大致上可以正常工作，除了下面的 TODO 列表中的不完整项。

这是 v0.9.0 版本，所以它相当稳定，我不期望接口会有太大变化，如果有的话。

需求

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

入门

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

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

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

测试

此项目设置为使用基本的 PHPUnit 配置。我恰好使用了 3.7.8，但这不应该有太大影响。从项目根目录，您应该能够执行以下测试：

phpunit tests/

TODO

这个库尚未完成，以下是活跃的 TODO 列表。

• 对于 Person 资源
• 实现通过电子邮件和 emailMD5 查找
• 实现输出样式（仅通过电子邮件查找）
• 实现通过电话查找
• 实现 countryCode 用于非 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

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