README

由 @MySportsFeeds 带来的 MySportsFeeds PHP Wrapper。

利用 MySportsFeeds API - 一个灵活、面向开发者的体育数据 API。

非商业用途免费。

##安装

使用 composer，只需将其添加到 composer.json 文件的 "require" 部分

"require": {
    "mysportsfeeds/mysportsfeeds-php": ">=2.1.0"
}

如果您还没有注册 API 访问，请在此处注册 https://www.mysportsfeeds.com/index.php/register/

##使用

使用 API 版本作为输入参数创建主 MySportsFeeds 对象

对于 v1.x 数据请求（免费非商业访问可用）

use MySportsFeeds\MySportsFeeds;

$msf = new MySportsFeeds("1.2");

对于 v2.0 数据请求（非商业访问需要捐款）

use MySportsFeeds\MySportsFeeds;

$msf = new MySportsFeeds("2.0");

为 v1.x 进行认证（使用您的 MySportsFeeds 账户密码）

$msf->authenticate("<YOUR_API_KEY>", "<YOUR_ACCOUNT_PASSWORD>");

为 v2.0 进行认证（只需使用 "MYSPORTSFEEDS" 作为密码）

$msf->authenticate("<YOUR_API_KEY>", "MYSPORTSFEEDS");

开始发送请求，按以下顺序指定：$league, $season, $feed, $format，以及任何适用的 feed 参数。请参阅 example.php 以获取示例用法。

示例（v1.x）：获取 Stephen Curry 在 2016-2017 NBA 常规赛季的所有比赛日志，以 JSON 格式

    $data = $msf->getData('nba', '2016-2017-regular', 'player_gamelogs', 'json', 'player=stephen-curry');

示例（v1.x）：获取所有 Dallas Cowboys 球员在 2015-2016 NFL 常规赛季的赛季统计总和，以 XML 格式

    $data = $msf->getData('nfl', '2015-2016-regular', 'cumulative_player_stats', 'xml', 'team=dallas-cowboys');

示例（v1.x）：获取 2016 MLB 季后赛季的全场赛程，以 CSV 格式

    $data = $msf->getData('mlb', '2016-playoff', 'full_game_schedule', 'csv');

示例（v2.0）：获取 Stephen Curry 在 2016-2017 NBA 常规赛季的所有比赛日志，以 JSON 格式

    $data = $msf->getData('nba', '2016-2017-regular', 'seasonal_player_gamelogs', 'json', 'player=stephen-curry');

示例（v2.0）：获取所有 Dallas Cowboys 球员在 2015 NFL 常规赛季的赛季统计总和，以 XML 格式

    $data = $msf->getData('nfl', '2015-regular', 'seasonal_player_stats', 'xml', 'team=dallas-cowboys');

示例（v2.0）：获取 2016 MLB 季后赛季的全场赛程和比分，以 CSV 格式

    $data = $msf->getData('mlb', '2016-playoff', 'seasonal_games', 'csv');

就这样！返回的数据默认也存储在 "results/" 目录下，以适当的文件名命名。

mysportsfeeds / mysportsfeeds-php