README

PHPShopify 是 Shopify API 的简单 SDK 实现。它帮助以面向对象的方式访问 API。

安装

使用 Composer 安装

composer require phpclassic/php-shopify

要求

PHPShopify 使用 curl 扩展来处理 HTTP 请求。因此，您需要安装并启用 PHP 中的 curl 扩展。

但是，如果您更喜欢使用任何其他可用的包库来处理 HTTP 请求，您可以通过修改 PHPShopify\HttpRequestJson 类中的每个 get()、post()、put()、delete() 方法中的 1 行代码来实现。

用法

您可以使用 PHPShopify 以非常简单的方式使用面向对象。

配置 ShopifySDK

如果您正在使用自己的私有 API，请提供 ApiKey 和密码。

$config = array(
    'ShopUrl' => 'yourshop.myshopify.com',
    'ApiKey' => '***YOUR-PRIVATE-API-KEY***',
    'Password' => '***YOUR-PRIVATE-API-PASSWORD***',
);

PHPShopify\ShopifySDK::config($config);

对于第三方应用程序，请使用永久访问令牌。

$config = array(
    'ShopUrl' => 'yourshop.myshopify.com',
    'AccessToken' => '***ACCESS-TOKEN-FOR-THIRD-PARTY-APP***',
);

PHPShopify\ShopifySDK::config($config);

如何获取商店的永久访问令牌？

有一个 AuthHelper 类可以帮助您使用 OAuth 从商店获取永久访问令牌。

首先，您需要使用额外的参数 SharedSecret 配置 SDK。

$config = array(
    'ShopUrl' => 'yourshop.myshopify.com',
    'ApiKey' => '***YOUR-PRIVATE-API-KEY***',
    'SharedSecret' => '***YOUR-SHARED-SECRET***',
);

PHPShopify\ShopifySDK::config($config);

创建认证请求

重定向 URL 必须从您的应用管理员中列出为 应用重定向 URL 之一。

//your_authorize_url.php
$scopes = 'read_products,write_products,read_script_tags,write_script_tags';
//This is also valid
//$scopes = array('read_products','write_products','read_script_tags', 'write_script_tags'); 
$redirectUrl = 'https://yourappurl.com/your_redirect_url.php';

\PHPShopify\AuthHelper::createAuthRequest($scopes, $redirectUrl);

如果您希望函数返回认证 URL 而不是自动重定向，可以将参数 $return（第 5 个参数）设置为 true。

\PHPShopify\AuthHelper::createAuthRequest($scopes, $redirectUrl, null, null, true);

在应用程序授权后重定向到 $redirectUrl 时获取访问令牌。

//your_redirect_url.php
PHPShopify\ShopifySDK::config($config);
$accessToken = \PHPShopify\AuthHelper::getAccessToken();
//Now store it in database or somewhere else

您可以使用相同的页面来创建请求和获取访问令牌（重定向 URL）。在这种情况下，只需在调用 createAuthRequest() 方法时跳过第 2 个参数 $redirectUrl。AuthHelper 类将为您完成剩余的操作。

//your_authorize_and_redirect_url.php
PHPShopify\ShopifySDK::config($config);
$accessToken = \PHPShopify\AuthHelper::createAuthRequest($scopes);
//Now store it in database or somewhere else

获取 ShopifySDK 对象

$shopify = new PHPShopify\ShopifySDK;

您可以在实例化对象时提供配置作为参数（如果您还没有通过调用 config() 方法进行配置）

$shopify = new PHPShopify\ShopifySDK($config);

现在，您可以通过对象导向的方式调用对象的资源（例如 `get()`、`post()`、`put()`、`delete()`）来执行。所有资源都命名为与 Shopify API 参考中相同。（请参阅下面的资源映射。）

如果请求成功，所有请求都返回一个数组（可以是单个资源数组或多个资源的数组）。当不需要结果时（例如 DELETE 请求），将返回一个空数组。

获取所有产品列表（GET 请求）

$products = $shopify->Product->get();

通过 ID 获取任何特定的产品（GET 请求）

$productID = 23564666666;
$product = $shopify->Product($productID)->get();

您还可以通过 URL 参数（如 Shopify API 参考中每个特定资源的指定）过滤结果。

例如，获取指定日期和时间之后已取消的订单列表（以及 fields 指定要渲染的每行数据列）

$params = array(
    'status' => 'cancelled',
    'created_at_min' => '2016-06-25T16:15:47-04:00',
    'fields' => 'id,line_items,name,total_price'
);

$orders = $shopify->Order->get($params);

创建新的订单（POST 请求）

$order = array (
    "email" => "foo@example.com",
    "fulfillment_status" => "unfulfilled",
    "line_items" => [
      [
          "variant_id" => 27535413959,
          "quantity" => 5
      ]
    ]
);

$shopify->Order->post($order);

请注意，您不需要将数据数组包装在资源键（在这种情况下为 order）中，这是 Shopify API 期望的语法。这由本 SDK 自动处理。

更新订单（PUT 请求）

$updateInfo = array (
    "fulfillment_status" => "fulfilled",
);

$shopify->Order($orderID)->put($updateInfo);

删除 Webhook（DELETE 请求）

$webHookID = 453487303;

$shopify->Webhook($webHookID)->delete());

子资源可以以嵌套的方式使用。

在尝试获取任何子资源时，您必须提供父资源的 ID。

例如，获取产品的图片（GET 请求）

$productID = 23564666666;
$productImages = $shopify->Product($productID)->Image->get();

为客户添加新地址（POST请求）

$address = array(
    "address1" => "129 Oak St",
    "city" => "Ottawa",
    "province" => "ON",
    "phone" => "555-1212",
    "zip" => "123 ABC",
    "last_name" => "Lastnameson",
    "first_name" => "Mother",
    "country" => "CA",
);

$customerID = 4425749127;

$shopify->Customer($customerID)->Address->post($address);

创建履约事件（POST请求）

$fulfillmentEvent = array(
    "status" => "in_transit"
);

$shopify->Order($orderID)->Fulfillment($fulfillmentID)->Event->post($fulfillmentEvent);

更新博客文章（PUT请求）

$blogID = 23564666666;
$articleID = 125336666;
$updateArtilceInfo = array(
    "title" => "My new Title",
    "author" => "Your name",
    "tags" => "Tags, Will Be, Updated",
    "body_html" => "<p>Look, I can even update through a web service.<\/p>",
);
$shopify->Blog($blogID)->Article($articleID)->put($updateArtilceInfo);

从特定博客中删除任何特定文章（DELETE请求）

$blogArticle = $shopify->Blog($blogID)->Article($articleID)->delete();

GraphQL ^v1.1

GraphQL Admin API是基于GraphQL的REST Admin API替代品，它使Shopify管理后台的功能可通过单个GraphQL端点访问。支持的完整类型集合可在GraphQL Admin API参考中找到。您可以简单地调用GraphQL资源，并通过GraphQL字符串进行POST请求。

GraphQL Admin API需要访问令牌才能进行认证请求。您可以通过创建私有应用并使用该应用的API密码，或通过遵循OAuth授权流程来获取访问令牌。请参阅GraphQL认证指南

$graphQL = <<<Query
query {
  shop {
    name
    primaryDomain {
      url
      host
    }
  }
}
Query;

$data = $shopify->GraphQL->post($graphQL);

GraphQL Builder

此SDK仅接受GraphQL字符串作为输入。您可以从Shopify GraphQL Builder构建您的GraphQL。

资源映射

一些资源直接可用，一些资源仅通过父资源可用，而一些资源两种方式均可访问。建议您查看每个资源的相关Shopify API参考页面中的详细信息。这里每个资源名称都链接到相关的Shopify API参考页面。

仅通过列出的资源映射使用资源。尝试直接获取仅通过父资源可用的资源可能会导致错误。

AbandonedCheckout
ApplicationCharge
Blog
Blog -> Article
Blog -> Article -> Event
Blog -> Article -> Metafield
Blog -> Event
Blog -> Metafield
CarrierService
Collect
Comment
Comment -> Event
Country
Country -> Province
Currency
CustomCollection
CustomCollection -> Event
CustomCollection -> Metafield
Customer
Customer -> Address
Customer -> Metafield
Customer -> Order
CustomerSavedSearch
CustomerSavedSearch -> Customer
DraftOrder
Discount (仅限Shopify Plus)
DiscountCode
Event
FulfillmentService
GiftCard (仅限Shopify Plus)
InventoryItem
InventoryLevel
Location (只读)
Location -> InventoryLevel
Metafield
Multipass (仅限Shopify Plus，API尚未提供)
订单
订单 -> 履行
订单 -> 履行 -> 事件
订单 -> 风险
订单 -> 退款
订单 -> 交易
订单 -> 事件
订单 -> 元字段
页面
页面 -> 事件
页面 -> 元字段
策略 (只读)
产品
产品 -> 图片
产品 -> 变体
产品 -> 变体 -> 元字段
产品 -> 事件
产品 -> 元字段
产品列表
产品变体
产品变体 -> 元字段
周期性应用费用
周期性应用费用 -> 使用费用
重定向
脚本标签
配送区域 (只读)
商店 (只读)
智能收集
智能收集 -> 事件
主题
主题 -> 资产
用户 (只读，仅限Shopify Plus)
Webhook
GraphQL

自定义操作

有几个操作方法可以在不直接调用 get()、post()、put()、delete() 方法的情况下调用，但最终会调用这些方法之一进行自定义调用。

例如，获取项目总数

$productCount = $shopify->Product->count();

为顾客设置默认地址。

$shopify->Customer($customerID)->Address($addressID)->makeDefault();

搜索居住在美国的名为 "Bob" 的顾客。

$shopify->Customer->search("Bob country:United States");

自定义操作列表

自定义方法特定于某些资源，这些资源可能对其他资源不可用。建议您查看相关Shopify API参考页面中每个操作的详细信息。我们在此仅列出可用的操作及其简要信息，每个操作名称都链接到Shopify API参考中的示例，其中包含更多详细信息。

(除 ApplicationCharge、CarrierService、FulfillmentService、Location、Policy、RecurringApplicationCharge、ShippingZone、Shop、Theme 之外的所有资源类型) ->
- count() 获取所有资源的数量。与所有其他操作不同，此函数返回一个整数值。
评论 ->
- markSpam() 将评论标记为垃圾邮件
- markNotSpam() 标记评论为非垃圾邮件
- approve() 审批评论
- remove() 删除评论
- restore() 恢复评论
客户 ->
- search() 查找符合查询条件的客户
- send_invite($data) 向客户发送账户邀请。
客户 -> 地址 ->
- makeDefault() 将地址设置为客户的默认地址
- set($params) 对多个地址执行批量操作
草稿订单 ->
- send_invoice($data) 发送草稿订单的发票
- complete($data) 完成草稿订单
折扣 ->
- enable() 启用折扣
- disable() 禁用折扣
折扣代码 ->
- lookup($data) 获取折扣代码的位置。
履行 ->
- complete() 完成履行
- open() 打开待处理的履行
- cancel() 取消履行
礼品卡 ->
- disable() 禁用礼品卡。
- search() 查找符合查询条件的礼品卡
库存水平 ->
- adjust($data) 调整库存水平。
- connect($data) 将库存项目连接到位置。
- set($data) 设置位置内单个库存项目的库存水平。
订单 ->
- close() 关闭订单
- open() 重新打开已关闭的订单
- cancel($data) 取消订单
订单 -> 退款 ->
- calculate() 计算退款。
产品列表 ->
- productIds() 获取发布到您应用的产品_id。
周期性应用费用 ->
- activate() 激活周期性应用费用
- customize($data) 定制周期性应用费用
智能收藏夹 ->
- sortOrder($params) 设置智能集合中产品的排序类型和/或手动顺序
用户 ->
- current() 获取当前登录用户

参考

Shopify API 参考文档

捐赠

如果这个项目帮助您减少了开发时间，您可以捐赠任何金额，这将帮助我们投入更多时间到这个项目中，并确保更频繁的更新。

seka19 / php-shopify

维护者

详细信息

README

安装

要求

用法

配置 ShopifySDK

如何获取商店的永久访问令牌？

获取 ShopifySDK 对象

现在，您可以通过对象导向的方式调用对象的资源（例如 `get()`、`post()`、`put()`、`delete()`）来执行。所有资源都命名为与 Shopify API 参考中相同。（请参阅下面的资源映射。）

子资源可以以嵌套的方式使用。

GraphQL ^v1.1

GraphQL Builder

资源映射

自定义操作

自定义操作列表

参考

捐赠

seka19 / php-shopify

维护者

详细信息

README

安装

要求

用法

配置 ShopifySDK

如何获取商店的永久访问令牌？

获取 ShopifySDK 对象

现在，您可以通过对象导向的方式调用对象的资源（例如 get()、post()、put()、delete()）来执行。所有资源都命名为与 Shopify API 参考中相同。（请参阅下面的资源映射。）

子资源可以以嵌套的方式使用。

GraphQL v1.1

GraphQL Builder

资源映射

自定义操作

自定义操作列表

参考

捐赠

现在，您可以通过对象导向的方式调用对象的资源（例如 `get()`、`post()`、`put()`、`delete()`）来执行。所有资源都命名为与 Shopify API 参考中相同。（请参阅下面的资源映射。）

GraphQL ^v1.1