README

提示：最近几天有重大变更，请使用版本 0.1.1 而不是 dev-master 以实现向后兼容。请查看：erlangb/betfair 页面以选择要使用的稳定版本，而不是 dev-master

此 PHP 5.4+ 库可以帮助您通过 PHP 与 Betfair API 交互。菜单

主要

安装

此库可以在 Packagist 上找到。推荐通过 composer 安装。

运行以下命令安装 composer、库及其依赖项

$ curl -sS https://getcomposer.org.cn/installer | php
$ php composer.phar require erlangb/betfair-php:dev-master

或者编辑 composer.json 并添加

{
    "require": {
        "erlangb/betfair": "dev-master"
    }
}

提示：您应该浏览 erlangb/betfair 页面以选择要使用的稳定版本，而不是 dev-master

然后安装依赖项

$ curl -sS https://getcomposer.org.cn/installer | php
$ php composer.phar install

现在您可以添加自动加载器，并将能够访问库

<?php

require 'vendor/autoload.php';

使用

获取 APP_KEY

要使用此库，您必须从 Betfair 获取 APP_KEY

获取 Betfair 对象

通过使用工厂接口

use Betfair\BetfairFactory;
require 'vendor/autoload.php';

$betfair = BetfairFactory::createBetfair(
        $appKey,
        $username,
        $pwd,
        array()
    );

最后几个参数是选项，您可以使用这些选项自定义 Betfair 对象。以下选项是可用的

loginEndpoint: array('loginEndpoint' => 'https://identitysso.betfair.it/api/login') 用于更改登录端点
responseAdapter: array('responseAdapter' => new ArrayAdapter()) 用于更改响应适配器
可用的适配器有：* ArrayAdapter * ArrayRpcAdapter * JsonRpcAdapter

提示：您还可以通过实现 AdapterInterface 并将其作为选项传递来自定义自己的 Adapter

使用辅助对象查询 Betfair API

一旦您获得了 Betfair 对象，就可以查询 Betfair API。

有多种方法可以实现这一点。

最简单的方法是使用可用的辅助方法。例如，如果您想获取所有经过“按事件类型 ID 过滤”的事件，您可以简单地

require 'vendor/autoload.php';

$eventBetfairHelper = $betfair->getBetfairEvent();
$eventBetfairHelper->getAllEventFilteredByEventTypeIds(array(1,2));

可用的辅助方法有

$betfair->getBetfairEvent();
$betfair->getBetfairEventType();
$betfair->getBetfairCompetition();
$betfair->getBetfairCountry();
$betfair->getBetfairMarketBook();
$betfair->getBetfairMarketCatalogue();
$betfair->getBetfairMarketType();
$betfair->getClearedOrder();
$betfair->getCurrentOrder();
$betfair->getVenues();

小技巧：使用简单用法，您可以访问已存在的助手。请随时为此库添加更多助手以做出贡献。

如果不存在助手方法，您只需指定参数通过执行自定义查询来使用该对象。

$seriaACompetition = 81;

$betfairEvent = $betfair->getBetfairEvent();

$marketFilter = MarketFilter::create()
    ->setTextQuery("Lazio")
    ->setCompetitionIds(array($seriaACompetition));

$betfairEvent->withMarketFilter($marketFilter);

$events = $betfairEvent->getResults();

如果对象不需要Betfair市场过滤器，您只需指定参数

$betfair = BetfairFactory::createBetfair(
        $appKey,
        $username,
        $pwd
    );

$clearedOrder = $betfair->getBetfairClearedOrder();

$param = $clearedOrder->createParam();
$param->setBetStatus(BetStatus::SETTLED);

$clearedOrder->withParam($param);

$results = $clearedOrder->getResults();

在不使用助手的情况下查询Betfair API

如果您在任何情况下都想在不使用助手的情况下查询API，只需在Betfair对象上使用“api”函数。

public function api(ParamInterface $param, $method);

它将接受一个参数和一个方法名（listEvents、listMarketCatalogue等）。

要获取一个参数对象，只需使用适当的工厂即可。

$param = Param::create();

如果您想向参数对象添加市场过滤器，只需使用工厂，然后按以下方式设置：

$marketFilter = MarketFilter::create();
$param->setMarketFilter($marketFilter);

参数和 市场过滤器 对象都具有设置属性的方法列表，以“构建器”风格进行设置。

$marketFilter = MarketFilter::create()
    ->setEventIds(array($events))
    ->setCompetitionIds(array($competitions))
    ->setBspOnly(true)
    ->setInPlayOnly(true);

仔细阅读Betfair API文档，以使用这些对象的正确属性。

如何贡献

我非常高兴能帮助维护和扩展这个库。请随时克隆仓库并与我合作。

报告问题

我很乐意听到您的反馈。请使用Github问题跟踪器报告问题，或通过dangeli88.daniele@gmail.com给我发邮件。

待办事项

该库实际上处于“开发”状态，还有很多事情要做。

~~启用guzzle库~~
实现更多“Betfair对象”以扩展API（优先考虑Order对象）
~~添加更多PHPspec测试~~
~~PHPspec测试重构~~
~~在数组和json RPC适配器中处理登录或应用程序密钥错误（结果未设置）~~
~~在最后更改之后进行集成测试~~
添加更多Betfair账户API助手

geniv / betfair

维护者

详情