README

Shopify API 适配器

• 连接到 Shopify API
• Guzzle 支持
• 方便的 composer 安装
• PSR 兼容
• 与 Erdiko 或您喜欢的框架一起使用

如果您使用 composer 且 PHP 版本为 5.3 或更高，则此包非常适合使用。它与 Laravel、Symfony、SlimPHP 和当然还有 Erdiko 这样的框架兼容。

如果您使用 PHP 4 或不使用 composer，请查看 ohShopify

安装

通过 composer

composer require erdiko/shopify

使用

要连接到 Shopify，您可以使用 \erdiko\shopify\Shopify 类来连接到 Shopify API。此库可以用于支持 composer 的任何 PHP 应用程序。

如果您使用 Erdiko，可以利用我们的服务模型和示例应用程序来快速开始您的开发。

使用您的 Shopify 店铺授权您的应用程序

此模块依赖于 OAuth 来访问和交互您的 Shopify 店铺。此模块的授权仅用于设置，但每个商店都需要授权。

使用 OAuth 授权您的应用程序的工作流程是通过构造一个链接允许 Shopify 安装此应用程序来“请求权限”。您需要公开您的应用程序到一个 URL，以便您可以重定向并访问。编辑您的路由配置，以确保我们构建并输出 Shopify 期望的输出，如下所示

 {
     "routes": {
     	...
        "shop": "\erdiko\shopify\controllers\Shopify",
        ...
     }
 }

虽然我们将您转交到 官方 Shopify 文档 以获取完整说明，但以下是授权您的应用程序的简要说明

• 在 Shopify Partners Dashboard 中注册您的应用程序
• 检索您新创建应用程序的 API 密钥、API 密钥和刷新令牌（也称为“nonce”）
• 通过编辑以下 URL 构造您的“权限提示”URL

https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}

令牌

• {shop}
  • 您的 Shopify 店铺的子域
• {api_key}
  • 这是您的 API 密钥
• {scopes}
  • 这是您允许应用程序使用的权限列表，以逗号分隔
  • 我们建议以下权限： write_products,write_orders,write_customers
• {nonce}
  • 您的刷新令牌，也称为“nonce”
• {redirect_url}
  • 您的 Erdiko 应用程序公开的公开访问路由，其中初始化了 Shopify 模型

Erdiko 应用程序骨架

如果您使用 Erdiko（http://www.erdiko.org），有一些用于与 Shopify 交互的有用代码（超出基本 API 库）。

要将此骨架应用程序安装到您现有的 Erdiko 应用程序中，只需 3 步。

1. 将 erdiko-shopify /app 文件夹的内容复制到您站点相关的 /app 文件夹中。

2. 使用您的特定 Shopify 设置修改 app/config/default/shopify.json

3. 在 routes.json 文件中添加到 Shopfy 控制器的路由。类是 /erdiko/shopify/controllers/Shopify。

反馈

如果您有任何疑问或建议，请向我们发送反馈。如果您发现任何错误或发现我们不遵守 PSR，请提交 GitHub 问题或给我们发送电子邮件。

特别感谢

Arroyo Labs - 赞助开发，http://arroyolabs.com

cmcdonaldca/ohShopify.php - 原始 Shopify PHP 类