README

注册 RBLTracker 账户并访问我们的 开发者网站 获取更多详细信息。

PHP 客户端库

您 RBLTracker 服务的官方 PHP 绑定。

先决条件

在使用此库之前，您必须拥有

• RBLTracker 账户，注册新账户 或 登录 RBLTracker
• 有效的 RBLTracker 账户 SID 和认证令牌，可在 RBLTracker 门户 获取
• PHP >= 7.4
• PHP JSON 扩展

安装

composer require rbltracker/sdk

快速入门

获取您账户上的主机列表

<?php

$client = new RBLTracker\Client('your_account_sid', 'your_auth_token');

try
{
    $hosts = $client->hosts->get([ 'page_size' => 5, 'page' => 2 ]);

    print_r($hosts);

} catch(RBLTracker\Exceptions\RBLTrackerException $e)
{
    echo $e->getMessage();
}

这将输出一个类似以下的 PHP 数组

Array
(
    [status_code] => 200
    [status_message] => Ok
    [total_hosts] => 1
    [total_listed] => 1
    [page] => 1
    [total_pages] => 1
    [page_size] => 20
    [data] => Array
        (
            [0] => Array
                (
                    [id] => HTee06c4fa7c23aa8a3a4e8d66922b0834
                    [host] => bad-url.com
                    [name] => bad-url.com
                    [type] => uribl
                    [parent] => 
                    [status] => active
                    [rbl_profile] => RP15d4e891d784977cacbfcbb00c48f133
                    [contact_group] => CGd3dca251d33135e0a518d7c49b89dc61
                    [last_checked] => 2016-11-07 21:01:33 EST
                    [first_listed] => 2016-11-06 10:14:58 EST
                    [listed_period] => 1 day 11:37:51
                    [listed] => 1
                    [listed_count] => 1
                    [listed_details] => Array
                        (
                            [0] => Array
                                (
                                    [host] => Google Safe Browsing
                                    [website] => 
                                    [details] => Malware (Virus) on Windows
                                )
                        )
                )
        )
    [version] => 3.4
)

文档

完整的 API 文档可在 RBLTracker 开发者网站 获取。

版本历史

v1.1.0

• 更新为使用新的 API 端点 URL
• 添加了严格的类型要求；最低版本提升到 PHP 7.4
• 添加了对监控配置文件的支持，远离 RBL 配置文件
• 添加了对 ACLs 端点的支持，以拉取用于检查的 DNS 服务器列表

v1.0.3

• 修复了 RBLTrackerException.php 中的错误，其中使用了短开标签。
• 将 array() 实例更改为 []。
• 更新类以使用 final 关键字。

v1.0.2

• 更新为支持 RBLTracker API v3.6
• 添加了手动 RBL 检查支持
• 重构了代码布局，以便更容易覆盖测试中的 URL

v1.0.1

• 更新为支持 RBLTracker API v3.4

v1.0.0

• 首次发布