Download the PHP package oxid-esales/graphql-base without Composer
On this page you can find all versions of the php package oxid-esales/graphql-base. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download oxid-esales/graphql-base
More information about oxid-esales/graphql-base
Files in oxid-esales/graphql-base
Package graphql-base
Short Description OXID eSales GraphQL base module
License proprietary
Homepage https://www.oxid-esales.com
Informations about the package graphql-base
oxid-esales/graphql-base
This module provides:
- a basic GraphQL implementation for the OXID eShop
- authorization and authentication using JWT
- a query to log you in and get a JWT for further authentication
Documentation
- Full documentation, including GraphQL schema, can be found here.
Usage
This assumes you have OXID eShop (at least OXID-eSales/oxideshop_ce: v7.2.0
component, which is part of the 7.2.0
compilation) up and running.
Branch Compatibility
- 10.x versions (or b-7.2.x branch) are compatible with latest shop compilation 7.2.x resp. b-7.2.x shop compilation branches
- 9.x versions (or b-7.1.x branch) are compatible with latest shop compilation 7.1.x resp. b-7.1.x shop compilation branches
- 8.x versions (or b-7.0.x branch) are compatible with latest shop compilation: 7.0.x resp. b-7.0.x shop compilation branches
- 7.x versions (or b-6.5.x branch) are compatible with latest shop compilations: 6.5.x resp. b-6.5.x shop compilation branches
- 6.x versions (or b-6.4.x branch) are compatible with latest shop compilations: 6.4.x resp. b-6.4.x shop compilation branches
- 5.x versions (or b-6.3.x branch) are compatible with latest shop compilations: 6.3.x resp. b-6.3.x shop compilation branches (NOTE: no support for PHP 8 yet)
Install
You should run migrations both after installing the module and after each module update:
After requiring the module, you need to activate it, either via OXID eShop admin or CLI.
Update
If you when to update this module from older version to new version. Then run below command to ensure that all dependencies including in the composer.lock are updated that are compatible with each other.
How to use
You can use your favourite GraphQL client to explore the API, if you do not already have one installed, you may use Altair GraphQL Client.
To login and retrieve a token send the following GraphQL query to the server
You could simply fire up your terminal and use curl
to do a basic check
if the GraphQL base module is up and running as expected. To retrieve a valid
token you need to replace the username and password below with valid login
credentials.
You should see a response similar to this:
This token
is then to be send as your authorization with every request in the
HTTP Authorization
header like this:
How to use refresh tokens
To login and retrieve a refresh and access token send the following GraphQL query to the server:
The response should contain both requested tokens:
The request will set an HttpOnly
cookie with unique fingerprint.
The accessToken
claims contain a hashed version of this fingerprint.
The access token should be sent as Bearer type authorization as described above.
After the access token's lifetime has elapsed, you will need to refresh it.
To do this you will need to send the following query:
If the token is valid and the hash matches the fingerprint sent as cookie, you will receive a fresh token as a response:
And along with it, a new fingerprint cookie and fingerprintHash
claim in the jwt token.
How to extend
The information on extending any module can be found in the OXID eSales documentation.
How to extend GraphQL module types and implement your new mutations and queries is shown in OXID GraphQL API documentation.
Testing
Syntax check and static analysis
Unit/Integration/Acceptance tests
- install this module into a running OXID eShop
-
reset shop's database
-
run Unit/Integration tests
- run Acceptance tests
Issues
To report issues with GraphQL module please use the OXID eShop bugtracking system.
Contributing
You like to contribute? 🙌 AWESOME 🙌\ Go and check the contribution guidelines
Build with
License
OXID Module and Component License, see LICENSE file.
All versions of graphql-base with dependencies
ext-json Version *
thecodingmachine/graphqlite Version ^6.2
lcobucci/jwt Version ^4.1
symfony/cache Version *
ecodev/graphql-upload Version ^7.0.0
laminas/laminas-diactoros Version ^2.5
myclabs/php-enum Version ^1.8