SEOstats PHP库技术文档

1. 安装指南

1.1 依赖要求

SEOstats 需要 PHP 5.3 或更高版本，并且需要安装 PHP5-CURL 和 PHP5-JSON 扩展。

1.2 通过 Composer 安装

推荐使用 Composer 来安装 SEOstats。首先，创建一个 composer.json 文件，内容如下：

{
    "require": {
        "seostats/seostats": "dev-master"
    }
}

然后，在 composer.json 所在的目录下运行以下命令：

php composer.phar install

如果是 Windows 系统，可以直接运行：

composer install

1.3 手动安装

如果不使用 Composer，可以直接下载 SEOstats.zip 文件并解压。需要注意的是，当前版本在自动加载方面存在一些问题，因此需要按照示例文件中的说明进行配置。

2. 项目使用说明

2.1 配置

SEOstats 有两个配置文件需要注意：

1. ./SEOstats/Config/ApiKeys.php：用于配置客户端 API 密钥（目前仅适用于 Mozscape、Google 的 Pagespeed Service 和 Sistrix）。
2. ./SEOstats/Config/DefaultSettings.php：用于配置一些默认设置（主要是与查询数据相关的本地化设置）。

2.2 快速示例

要使用 SEOstats 的方法，首先需要包含一个自动加载器类。对于通过 Composer 安装的项目，使用 ./vendor/autoload.php；对于手动下载的项目，使用 ./SEOstats/bootstrap.php。

<?php
require_once __DIR__ . DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR . 'autoload.php';

use \SEOstats\Services as SEOstats;

try {
    $url = 'http://www.google.com/';

    // 创建一个新的 SEOstats 实例
    $seostats = new \SEOstats\SEOstats;

    // 绑定 URL 到当前的 SEOstats 实例
    if ($seostats->setUrl($url)) {
        echo SEOstats\Alexa::getGlobalRank();
        echo SEOstats\Google::getPageRank();
    }
} catch (SEOstatsException $e) {
    die($e->getMessage());
}

也可以直接通过静态方法调用，传入 URL 参数：

<?php
require_once __DIR__ . DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR . 'autoload.php';

try {
    $url = 'http://www.google.com/';

    // 获取给定 URL 的 Google Toolbar Pagerank
    echo \SEOstats\Services\Google::getPageRank($url);
} catch (SEOstatsException $e) {
    die($e->getMessage());
}

更多详细示例可以在 ./example 目录中找到。

3. 项目API使用文档

3.1 Alexa 方法

3.1.1 Alexa 流量指标

<?php
// 返回全球 Alexa 流量排名（过去 3 个月）
print Alexa::getGlobalRank();

// 返回过去一个月的全球流量排名
print Alexa::getMonthlyRank();

// 返回过去一周的全球流量排名
print Alexa::getWeeklyRank();

// 返回昨天的全球流量排名
print Alexa::getDailyRank();

// 返回特定国家的 Alexa 流量排名
print_r( Alexa::getCountryRank() );

// 返回给定域名的 Alexa 反向链接数量
print Alexa::getBacklinkCount();

// 返回给定域名的 Alexa 页面加载时间信息
print Alexa::getPageLoadTime();

3.1.2 Alexa 流量图表

<?php
// 返回 '每日流量趋势' 图表的 HTML 代码
print Alexa::getTrafficGraph(1);

// 返回 '每日页面浏览量（百分比）' 图表的 HTML 代码
print Alexa::getTrafficGraph(2);

// 返回 '每日页面浏览量每用户' 图表的 HTML 代码
print Alexa::getTrafficGraph(3);

// 返回 '网站停留时间（分钟）' 图表的 HTML 代码
print Alexa::getTrafficGraph(4);

// 返回 '跳出率（百分比）' 图表的 HTML 代码
print Alexa::getTrafficGraph(5);

// 返回 '搜索访问量' 图表的 HTML 代码，使用特定的图表尺寸 320*240 px
print Alexa::getTrafficGraph(6, 0, 320, 240);

3.2 Google 方法

3.2.1 Google Toolbar PageRank

<?php
// 返回给定 URL 的 Google PageRank
print Google::getPageRank();

3.2.2 Google Pagespeed Service

<?php
// 返回给定 URL 的 Google Pagespeed 分析指标
print_r( Google::getPagespeedAnalysis() );

// 返回 Google Pagespeed 分析的总分
print Google::getPagespeedScore();

3.3 Google Websearch Index

<?php
// 返回对象 URL 的 Google 站点搜索结果总数
print Google::getSiteindexTotal();

4. 项目安装方式

SEOstats 可以通过 Composer 或手动下载安装。推荐使用 Composer 进行安装，具体步骤见 安装指南。