kkgerry/laravel-amazon-mws

1.1.4 2020-12-14 03:01 UTC

This package is auto-updated.

Last update: 2024-09-15 17:22:12 UTC


README

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

目前优化用于Laravel框架。

这**不是**用于亚马逊网络服务(AWS)- 云计算服务。

安装

  1. composer require kkgerry/laravel-amazon-mws

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

Kkgerry\AmazonMws\ServiceProvider::class,

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

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

使用方法

API所需的全部技术细节都在幕后处理,因此用户可以轻松构建代码,向亚马逊发送请求,无需跨越参数URL格式化和令牌管理等障碍。使用对象的一般工作流程如下

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

请注意,如果您要操作多个亚马逊商店,您需要为每个商店创建一个单独的对象。

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

示例用法

以下是该库使用的几个示例。API所需的所有技术细节都在幕后处理,因此用户可以轻松构建代码,向亚马逊发送请求,无需跨越参数URL格式化和令牌管理等障碍。

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

use Kkgerry\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 Kkgerry\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();
}