xiaojinhua/laravel-amazon-mws

使用 Laravel x 的 Amazon MWS 网络服务。基于 creacoon/amazon-mws-laravel 包,并修改以兼容最新的 Laravel 版本(+ 错误修复)。

dev-master 2020-08-28 07:01 UTC

This package is not auto-updated.

Last update: 2024-09-22 00:56:45 UTC


README

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

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

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

安装

  1. composer require xiaojinhua/laravel-amazon-mws

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

Xiaojinhua\AmazonMws\ServiceProvider::class,

在 config/app.php 中无需添加外观

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

使用方法

API 所需的所有技术细节都在幕后处理,因此用户可以轻松构建发送请求到亚马逊的代码,无需跳过诸如参数 URL 格式化和令牌管理之类的障碍。使用其中一个对象的一般工作流程如下

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

请注意,如果您想对多个亚马逊商店采取行动,您将需要为每个商店创建一个单独的对象。

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

示例使用

这里有一些使用该库的示例。API 所需的所有技术细节都在幕后处理,因此用户可以轻松构建发送请求到亚马逊的代码,无需跳过诸如参数 URL 格式化和令牌管理之类的障碍。

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

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