PHPackages                             webtize/shopify-graphql-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. webtize/shopify-graphql-sdk

ActiveLibrary[API Development](/categories/api)

webtize/shopify-graphql-sdk
===========================

Modern PHP SDK for Shopify GraphQL Admin API

1.0.3(9mo ago)188MITPHPPHP ^8.2

Since Aug 15Pushed 9mo agoCompare

[ Source](https://github.com/webtize/shopify-graphql-webtize-php-sdk)[ Packagist](https://packagist.org/packages/webtize/shopify-graphql-sdk)[ RSS](/packages/webtize-shopify-graphql-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (9)Versions (4)Used By (0)

Shopify GraphQL PHP SDK
=======================

[](#shopify-graphql-php-sdk)

A modern, PSR-compliant PHP SDK for interacting with Shopify's GraphQL Admin API. This SDK provides a clean, object-oriented interface with automatic HTTP client discovery, rate limiting, error handling, and convenient resource helpers.

Features
--------

[](#features)

- 🚀 **Modern PHP 8.1+** with strict typing and best practices
- 🔌 **PSR-18/17 Compliant** - Works with any HTTP client (Guzzle, Symfony, etc.)
- 🛡️ **Automatic Rate Limiting** with exponential backoff and retry logic
- 🎯 **Type-Safe GraphQL** operations with query builder
- 📦 **Resource Helpers** for common operations (Products, Orders, etc.)
- ⚡ **Auto-Discovery** of HTTP clients and factories
- 🔍 **Comprehensive Error Handling** with specific exceptions
- 📖 **Extensive Documentation** and examples

Installation
------------

[](#installation)

Install via Composer:

```
composer require webtize/shopify-graphql-sdk:@dev
```

For HTTP client support, also install one of the following:

```
# For Guzzle (recommended)
composer require php-http/guzzle7-adapter

# For Symfony HTTP Client
composer require symfony/http-client php-http/httplug-bundle

# For cURL adapter
composer require php-http/curl-client php-http/message
```

Quick Start
-----------

[](#quick-start)

### Basic Setup

[](#basic-setup)

```
use ShopifyGraphQL\ClientFactory;

// Simple setup with auto-discovery
$client = ClientFactory::create(
    'your-store.myshopify.com',  // or just 'your-store'
    'your-access-token-here'
);

// Get shop information
$response = $client->getShopInfo();
if ($response->isSuccessful()) {
    $shop = $response->get('shop');
    echo "Shop: " . $shop['name'];
}
```

### Using Resource Helpers

[](#using-resource-helpers)

```
use ShopifyGraphQL\Products;

$products = new Products($client);

// List products
$response = $products->list(10);
foreach ($response->get('products.edges', []) as $edge) {
    echo $edge['node']['title'] . "\n";
}

// Get single product
$product = $products->get('gid://shopify/Product/123');
echo $product->get('product.title');

// Create product
$newProduct = $products->create([
    'title' => 'New Product',
    'productType' => 'Electronics',
    'vendor' => 'ACME Corp'
]);
```

### Custom Queries with Query Builder

[](#custom-queries-with-query-builder)

```
use ShopifyGraphQL\QueryBuilder;

$query = QueryBuilder::query('GetCustomers')
    ->variable('first', 'Int!', 10)
    ->field('customers', function($builder) {
        $builder->field('edges', function($edge) {
            $edge->field('node', [
                'id', 'email', 'firstName', 'lastName'
            ]);
        });
    });

$response = $client->query($query->build(), ['first' => 5]);
```

Configuration Options
---------------------

[](#configuration-options)

```
$client = ClientFactory::create(
    'your-store.myshopify.com',
    'your-access-token',
    [
        'timeout' => 30,           // Request timeout in seconds
        'max_retries' => 3,        // Max retry attempts for rate limits
        'headers' => [             // Additional headers
            'X-Custom-Header' => 'value'
        ]
    ]
);
```

Advanced Usage
--------------

[](#advanced-usage)

### Custom HTTP Client

[](#custom-http-client)

```
use GuzzleHttp\Client as GuzzleClient;use Http\Adapter\Guzzle7\Client as GuzzleAdapter;use Nyholm\Psr7\Factory\Psr17Factory;use ShopifyGraphQL\ClientFactory;

$httpClient = new GuzzleAdapter(new GuzzleClient([
    'timeout' => 60,
    'verify' => true
]));

$factory = new Psr17Factory();

$client = ClientFactory::createWithHttpClient(
    $httpClient,
    $factory,  // Request factory
    $factory,  // Stream factory
    'your-store.myshopify.com',
    'your-access-token'
);
```

### Error Handling

[](#error-handling)

```
use ShopifyGraphQL\AuthenticationException;use ShopifyGraphQL\RateLimitException;use ShopifyGraphQL\ShopifyGraphQLException;

try {
    $response = $client->query($query);

} catch (AuthenticationException $e) {
    echo "Invalid credentials: " . $e->getMessage();

} catch (RateLimitException $e) {
    echo "Rate limited. Retry after: " . $e->getRetryAfter() . " seconds";

} catch (ShopifyGraphQLException $e) {
    echo "GraphQL Error: " . $e->getMessage();

    if ($e->hasGraphqlErrors()) {
        foreach ($e->getGraphqlErrors() as $error) {
            echo "- " . $error['message'] . "\n";
        }
    }
}
```

### Pagination

[](#pagination)

```
$products = new Products($client);
$allProducts = [];
$cursor = null;

do {
    $response = $products->list(50, $cursor);

    if (!$response->isSuccessful()) {
        break;
    }

    $data = $response->get('products');
    $edges = $data['edges'] ?? [];

    foreach ($edges as $edge) {
        $allProducts[] = $edge['node'];
        $cursor = $edge['cursor'];
    }

    $hasNextPage = $data['pageInfo']['hasNextPage'] ?? false;

} while ($hasNextPage);
```

Available Resources
-------------------

[](#available-resources)

Currently implemented resource helpers:

- `Products` - Product management operations

More resources coming soon:

- Orders
- Customers
- Collections
- Inventory
- Fulfillments

GraphQL Query Builder
---------------------

[](#graphql-query-builder)

The included query builder provides a fluent interface for constructing GraphQL queries:

```
$query = QueryBuilder::query('GetProductsAndVariants')
    ->variable('productId', 'ID!')
    ->variable('first', 'Int', 10)
    ->field('product', function($builder) {
        $builder->field('id')
                ->field('title')
                ->field('variants', function($variantBuilder) {
                    $variantBuilder->field('edges', [
                        'node' => ['id', 'title', 'price']
                    ]);
                });
    })
    ->build();
```

Rate Limiting
-------------

[](#rate-limiting)

The SDK automatically handles Shopify's rate limiting:

- Detects 429 (rate limit) responses
- Implements exponential backoff retry strategy
- Respects `Retry-After` headers
- Configurable max retry attempts

Testing
-------

[](#testing)

Run the test suite:

```
composer test
```

Run static analysis:

```
composer phpstan
```

Fix code style:

```
composer cs-fix
```

Requirements
------------

[](#requirements)

- PHP 8.1 or higher
- A PSR-18 HTTP client implementation
- Valid Shopify store and access token

Contributing
------------

[](#contributing)

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Support
-------

[](#support)

- 📖 [Official Shopify GraphQL Documentation](https://shopify.dev/docs/api/admin-graphql)
- 🐛 [Issue Tracker](https://github.com/yourname/shopify-graphql-sdk/issues)
- 💬 [Discussions](https://github.com/yourname/shopify-graphql-sdk/discussions)

Changelog
---------

[](#changelog)

### v1.0.0

[](#v100)

- Initial release
- Core GraphQL client with PSR-18 support
- Query builder with fluent interface
- Products resource helper
- Automatic rate limiting and retries
- Comprehensive error handling

shopify-graphql-php-sdk
=======================

[](#shopify-graphql-php-sdk-1)

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance58

Moderate activity, may be stable

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

277d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/65f2990bd7bc0d74e4fe18ddc3dd59e8ffc3891b110f087cd767cbfd33c562f9?d=identicon)[j1g4r](/maintainers/j1g4r)

---

Top Contributors

[![j1g4r](https://avatars.githubusercontent.com/u/77252979?v=4)](https://github.com/j1g4r "j1g4r (7 commits)")

---

Tags

apisdkgraphqle-commerceshopify

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/webtize-shopify-graphql-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/webtize-shopify-graphql-sdk/health.svg)](https://phpackages.com/packages/webtize-shopify-graphql-sdk)
```

###  Alternatives

[openai-php/client

OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API

5.8k22.6M232](/packages/openai-php-client)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

963.1M35](/packages/getbrevo-brevo-php)[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.5k311.5k5](/packages/theodo-group-llphant)[wordpress/php-ai-client

A provider agnostic PHP AI client SDK to communicate with any generative AI models of various capabilities using a uniform API.

26236.6k14](/packages/wordpress-php-ai-client)[mozex/anthropic-php

Anthropic PHP is a supercharged community-maintained PHP API client that allows you to interact with Anthropic API.

46365.1k13](/packages/mozex-anthropic-php)[square/square

Use Square APIs to manage and run business including payment, customer, product, inventory, and employee management.

793.4M21](/packages/square-square)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)