解决ShopifyAPI集成难题：gnikyt/basic-shopify-api助你轻松驾驭

<code class="bash">composer require gnikyt/basic-shopify-api</code>

<pre class="brush:php;toolbar:false;">use Gnikyt\BasicShopifyAPI\BasicShopifyAPI;
use Gnikyt\BasicShopifyAPI\Options;
use Gnikyt\BasicShopifyAPI\Session;

// 1. 创建API配置选项
$options = new Options();
$options->setVersion('2023-10'); // 设置API版本，例如'2023-10'或'unstable'
$options->setApiKey(getenv('SHOPIFY_API_KEY')); // 如果是公共应用，需要设置API Key
$options->setApiSecret(getenv('SHOPIFY_API_SECRET')); // 如果是公共应用，需要设置API Secret

// 2. 创建API客户端并设置会话
// 对于公共应用，通常在OAuth认证后获取到access token
$api = new BasicShopifyAPI($options);
$api->setSession(new Session('your-shop-domain.myshopify.com', 'your-access-token-here'));

// 3. 发送RESTful请求
try {
    $result = $api->rest('GET', '/admin/shop.json');

    if (!$result['errors']) {
        echo "商店名称: " . $result['body']['shop']['name'] . "\n";
        echo "商店邮箱: " . $result['body']['shop']['email'] . "\n";
    } else {
        echo "API请求出错: " . $result['status'] . " - " . ($result['body']['errors'] ?? '未知错误') . "\n";
    }
} catch (\Exception $e) {
    echo "发生异常: " . $e->getMessage() . "\n";
}

<pre class="brush:php;toolbar:false;">// ... (前置配置与Session设置同上)

// 发送GraphQL查询
$query = '{ shop { name email } }';
$result = $api->graph($query);

if (!$result['errors']) {
    echo "GraphQL获取商店名称: " . $result['body']['shop']['name'] . "\n";
}

// 异步REST请求示例
$promise = $api->restAsync('GET', '/admin/products.json', ['limit' => 1]);
$promise->then(function (array $result) {
    if (!$result['errors']) {
        echo "异步获取第一个产品标题: " . ($result['body']['products'][0]['title'] ?? '无产品') . "\n";
    }
})->otherwise(function (\Exception $e) {
    echo "异步请求失败: " . $e->getMessage() . "\n";
});

// 在异步场景下，需要确保事件循环运行以处理Promise
// 如果你在一个非事件循环环境中，可以使用 GuzzleHttp\Promise\Utils::queue()->run();
// 或者直接使用 wait() 方法阻塞等待结果（不推荐用于生产环境异步操作）
// $promise->wait();