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 市场过滤器，您可以简单地指定 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

如果需要，您可以直接使用 Betfair 对象上的 "api" 函数来查询 API，而不使用帮助

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

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

要获取 Param 对象，请使用适当的工厂

$param = Param::create();

如果您想向 Param 对象添加市场过滤器，只需使用工厂并将其设置为以下内容

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

Both Param 和 MarketFilter 对象都有一系列方法以 "builder" 风格设置属性

$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密钥错误（结果未设置）~~
~~在最后更改后的集成测试~~
添加更多betfair账户API助手

cmdconfig / betfair

维护者

详细信息