README

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

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

主要

安装

此库可在 Packagist 上找到。推荐的安装方式是通过 composer。

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

$ curl -sS https://getcomposer.org/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/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 市场过滤器，您只需指定 Param

$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);

它将接受一个 Param 和一个方法名（listEevents、listMarketCatalogue ...）

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

$param = Param::create();

如果您想向 Param 对象添加市场过滤器，只需使用工厂并按以下方式设置它

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

Both Param 和 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适配器中的登录或app key错误（结果未设置）~~
~~在最后更改后的集成测试~~
添加更多betfair账户API辅助函数

janjansen / betfair-php

维护者

详情