Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Shopify/shopify-api-php
https://github.com/Shopify/shopify-api-php
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/Shopify/shopify-api-php
- Owner: Shopify
- License: mit
- Created: 2021-03-15T13:21:35.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-08T19:27:40.000Z (5 months ago)
- Last Synced: 2024-04-14T04:12:22.635Z (5 months ago)
- Language: PHP
- Size: 4.7 MB
- Stars: 333
- Watchers: 255
- Forks: 157
- Open Issues: 29
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Shopify API Library for PHP
[](LICENSE)
This library provides support for PHP [Shopify](https://www.shopify.com) apps to access the [Shopify Admin API](https://shopify.dev/docs/api/admin), by making it easier to perform the following actions:
- Creating [online](https://shopify.dev/docs/apps/auth#online-access) or [offline](https://shopify.dev/docs/apps/auth#offline-access) access tokens for the Admin API via OAuth
- Making requests to the [REST API](https://shopify.dev/docs/api/admin-rest)
- Making requests to the [GraphQL API](https://shopify.dev/docs/api/admin-graphql)
- Registering/processing webhooks
In addition to the Admin API, this library also allows querying the [Storefront API](https://shopify.dev/docs/api/storefront).
This library can be used in any application that has a PHP backend, since it doesn't rely on any specific framework—you can include it alongside your preferred stack and only use the features that you need to build your app.
# Requirements
To follow these usage guides, you will need to:
- have a basic understanding of [PHP](https://php.net)
- have a Shopify Partner account and development store
- _OR_ have a test store where you can create a private app
- have a private or custom app already set up in your test store or partner account
- use [ngrok](https://ngrok.com), in order to create a secure tunnel to your app running on your localhost
- add the `ngrok` URL and the appropriate redirect for your OAuth callback route to your app settings
# Getting started
You can follow our [getting started guide](docs/) to learn how to use this library's components.
- [Getting started](docs/getting_started.md)
- [Install dependencies](docs/getting_started.md#install-dependencies)
- [Set up the library](docs/getting_started.md#set-up-the-library)
- [Performing OAuth](docs/usage/oauth.md)
- [Begin OAuth](docs/usage/oauth.md#begin-oauth)
- [OAuth callback](docs/usage/oauth.md#oauth-callback)
- [REST Admin API](docs/usage/rest.md)
- [Make a GraphQL API call](docs/usage/graphql.md)
- [Make a Storefront API call](docs/usage/storefront.md)
- [Webhooks](docs/usage/webhooks.md)
- [Utilities](docs/usage/utils.md)
- [Known issues and caveats](docs/issues.md)
- [Notes on session handling](docs/issues.md#notes-on-session-handling)
# Developing this library
After cloning the repository, composer can install the dependencies:
```
composer install
```
To run tests:
```
composer test
```
If you want to get a code coverage report from the tests, you'll need to install the `php-xdebug` extension by running `pecl install xdebug`, and then run:
```
composer test -- [--coverage-text|--coverage-html=]
```
You may have to clear composer's autoload cache when namespaces change:
```
composer dump-autoload
```
To run linter:
```
composer lint
```
After having modified the `composer.json` file, make sure to run:
```
composer validate
composer normalize
```