README

一个用于以面向对象的方式连接到 Amazon 商家网络服务 (MWS) 的 PHP 包，重点在于直观的使用。

目前针对 Laravel 框架进行优化。

这不是用于 Amazon Web 服务 (AWS) - 云计算服务。

安装

1. composer require yogiri/laravel6-amazon-mws

2. 将服务提供者添加到 config/app.php 中的 providers 数组

Yogiri\AmazonMws\ServiceProvider::class,

不需要在 config/app.php 中添加门面

1. 将 src/config/amazon-mws.php 配置文件从 src/config 目录复制到 Laravel 的配置目录。

使用方法

API 所需的所有技术细节都由后台处理，因此用户可以轻松构建代码，向 Amazon 发送请求，无需跳过诸如参数 URL 格式化和令牌管理等障碍。使用对象的一般工作流程如下

1. 为需要执行的任务创建一个对象。
2. 使用 set____ 方法根据对象加载参数。
3. 将请求提交给 Amazon。执行此操作的方法通常命名为 fetch____ 或 submit____，并且没有参数。
4. 使用 get____ 方法引用返回的数据，无论是单个值还是批量。
5. 使用内置的日志系统监控库的性能。

注意，如果您要操作多个 Amazon 商店，您将需要为每个商店创建一个单独的对象。

还请注意，当对象不被视为可重用时，它们的表现最佳。否则，如果新请求失败，您可能会获取到旧的数据响应。

示例用法

以下是一些使用此库的示例。API 所需的所有技术细节都由后台处理，因此用户可以轻松构建代码，向 Amazon 发送请求，无需跳过诸如参数 URL 格式化和令牌管理等障碍。

以下是一个示例函数，用于获取过去 24 小时内更新的所有亚马逊仓库完成的订单

use Yogiri\AmazonMws\AmazonOrderList;

function getAmazonOrders() {
    $amz = new AmazonOrderList("myStore"); //store name matches the array key in the config file
    $amz->setLimits('Modified', "- 24 hours");
    $amz->setFulfillmentChannelFilter("MFN"); //no Amazon-fulfilled orders
    $amz->setOrderStatusFilter(
        array("Unshipped", "PartiallyShipped", "Canceled", "Unfulfillable")
        ); //no shipped or pending
    $amz->setUseToken(); //Amazon sends orders 100 at a time, but we want them all
    $amz->fetchOrders();
    return $amz->getList();
}

此示例展示了用于将之前创建的 XML 货单发送到亚马逊以更新库存编号的函数

use Yogiri\AmazonMws\AmazonOrderList;

function sendInventoryFeed($feed) {
    $amz = new AmazonFeed("myStore"); //store name matches the array key in the config file
    $amz->setFeedType("_POST_INVENTORY_AVAILABILITY_DATA_"); //feed types listed in documentation
    $amz->setFeedContent($feed);
    $amz->submitFeed();
    return $amz->getResponse();
}