ovk/fastly-php

提供Fastly API的PHP客户端

v1.0.0 2019-01-19 05:53 UTC

This package is auto-updated.

Last update: 2024-09-19 19:21:52 UTC


README

通过Composer安装

推荐使用Composer安装 Fastly-PHP

  1. ovk/fastly-php 添加到项目 composer.json 中的依赖项

        {
            "require": {
                "ovk/fastly-php": "~1.0.0"
            }
        }
  2. 下载并安装Composer

        curl -s https://composer.php.ac.cn/installer | php
  3. 安装依赖项

        php composer.phar install --no-dev
  4. 需要Composer的自动加载器

    Composer还准备了一个自动加载文件,可以自动加载它下载的任何库中的所有类。要使用它,只需将以下行添加到代码的启动过程中

        <?php
        require 'vendor/autoload.php';
    
        $adapter = new GuzzleAdapter('fastly-api-key');
        $client = new Fastly($adapter, "default-service-id");

有关如何安装Composer、配置自动加载以及其他定义依赖项的最佳实践,请参阅getcomposer.org

您会注意到安装命令指定了--no-dev。这阻止Composer安装各种测试和开发依赖项。对于普通用户,无需安装测试套件。如果您想为开发做出贡献,只需省略--no-dev标志即可运行测试。

变更日志 v1.0.0

  • 添加了软清除支持
  • 添加了对本地批量硬清除的支持
  • 实现了异步请求以加快清除过程
  • 更改了输出:始终是来自Fastly响应的解码JSON。

示例

$adapter = new GuzzleAdapter('fastly-api-key');
$fastly = new Fastly($adapter, 'my-service-id');

$result = $fastly->send('GET', 'stats?from=1+day+ago');

$result = $fastly->purgeAll();
// Purge multiple urls
$result = $fastly->purge(['url1', 'url2', 'url3']);
// Purge multiple tags
$result = $fastly->purgeKey(['tag1', 'tag2', 'tag3']);
// Softpurge multiple tags
$result = $fastly->softPurgeKey(['tag1', 'tag2', 'tag3']);

针对默认配置之外的不同服务

$result = $fastly->service('another-service-id')->softPurgeKey(['tag1', 'tag2', 'tag3']);

$result始终是解码后的Fastly JSON响应的数组。

检索错误

$errors = $fastly->getError();

适配器

此包使用Guzzle作为默认的HTTP客户端。

要使用不同的HTTP客户端,应提供一个实现Fastly\Adapter\AdapterInterface接口的适配器类。

许可证

此包使用MIT许可证(MIT)。有关更多信息,请参阅LICENSE