danabrey/mfl-api

用于与 MyFantasyLeague.com API 交互的 PHP 库

v1.11 2024-05-17 16:30 UTC

README

这是一个用于与 MyFantasyLeague.com API 交互的 PHP 库。它仍在开发中,我正在积极开发它以供其他项目使用。

安装

composer require danabrey/mfl-api

用法

创建客户端实例

$client = new DanAbrey\MFLApi\MFLApiClient(2020);

需要联赛年份。你可以选择性地将 API 密钥作为第二个参数传递,以便在所有请求中使用

$client = new DanAbrey\MFLApi\MFLApiClient(2020, 'my_api_key');

使用客户端方法向 API 发送请求,例如

$client->players();

$client->league('XXXXX') 其中 XXXXX 是联赛 ID。

$client->rosters('XXXXX') 其中 XXXXX 是联赛 ID。

所有方法都返回单个实例或表示返回数据的纯 PHP 对象数组。例如 MFLPlayerMFLRoster[] 等。

异常处理

该库抛出了一些异常,您可以根据自己的需要进行处理。它们都扩展了抽象类 DanAbrey\MFLApi\Exceptions\MFLApiException

UnauthorizedException:API 响应告知您,该端点需要 API 密钥才能访问该数据

InvalidParametersException:API 响应包含错误提示,表明您可能忘记传递所需的参数

UnknownApiError:API 响应包含 5xx HTTP 错误,通常这意味着 MFL 端的 API 存在问题

注意

您有责任遵守 MFL API 的条款

开发

我正在积极寻求此项目的贡献者。MFL API 是一个复杂且相当大的系统,在项目中访问其数据可能是一项繁琐的任务。该项目旨在通过自定义异常添加可靠的类型和可理解的错误处理。

如果您想参与其中,请随时提出问题。

运行测试

./vendor/bin/phpunit

树软件

此软件包采用 MIT 许可证,您可以在开源或封闭源代码项目中自由使用它。如果它进入您的生产环境,我会非常感激您为世界买下一些树。

现在众所周知,应对气候危机并防止气温升高超过 1.5C 的最佳工具之一是 种树。如果您为我的森林做出贡献,您将为当地家庭创造就业机会并恢复野生动物栖息地。

您可以在 offset.earth/treeware 购买树木。

有关 Treeware 的更多信息,请参阅 treeware.earth