sonnenglas/laravel-amazon-mws

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

6.0.0 2022-04-14 16:18 UTC

README

这是一个 PHP 包,以面向对象的方式连接到 Amazon 的 Merchant Web Services (MWS),重点在于直观的使用。

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

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

安装

  1. composer require sonnenglas/laravel5-amazon-mws

  2. 在 config/app.php 文件中的 providers 数组中添加服务提供者

Sonnenglas\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 小时内更新的所有由仓库完成的 Amazon 订单

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

此示例显示了用于向 Amazon 发送先前创建的 XML 馈送以更新库存编号的函数

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