oxid-esales / graphql-base
OXID eSales GraphQL base module
Installs: 57 320
Dependents: 8
Suggesters: 1
Security: 0
Stars: 15
Watchers: 11
Forks: 15
Type:oxideshop-module
Requires
- php: ^8.0
- ext-json: *
- ecodev/graphql-upload: ^6.1
- laminas/laminas-diactoros: ^2.5
- lcobucci/jwt: ^4.1
- myclabs/php-enum: ^1.8
- symfony/cache: *
- thecodingmachine/graphqlite: ^5.0.2
Requires (Dev)
- oxid-esales/oxideshop-ce: dev-b-7.0.x
- phpmd/phpmd: ^2.11
- phpstan/phpstan: ^0.12.26
- phpunit/phpunit: ^8.5|^9
- squizlabs/php_codesniffer: 3.*
- dev-b-7.0.x
- v8.0.1
- v8.0.0
- v7.0.2
- v7.0.1
- v7.0.0
- v6.0.3
- v6.0.2
- v6.0.1
- v6.0.0
- v5.2.1
- v5.2.0
- v5.2.0-rc2
- v5.2.0-rc1
- v5.1.1
- v5.1.0
- v5.0.0
- v4.0.0
- v3.2.0
- v3.1.3
- v3.1.2
- v3.1.1
- v3.1.0
- v3.0.0
- v2.5.0
- v2.4.1
- v2.4.0
- v2.3.0
- v2.2.0
- v2.1.0
- v2.0.0
- v1.3.3
- v1.3.2
- v1.3.1
- v1.3.0
- v1.2.0
- v1.1.2
- v1.1.1
- v1.1.0
- v1.0.0
- dev-b-7.0.x-update_phpstan-OXDEV-7206
- dev-b-6.5.x
- dev-b-7.0.x-review_preparation-OXDEV-7003
- dev-b-7.0.x-update_documentation-OXDEV-6731
- dev-b-7.0.x-fix_translations
- dev-b-7.0.x-github_actions-OXDEV-6153
- dev-b-7.0.x_sonar_fix
- dev-b-6.5.x-update-phpstan
- dev-master
- dev-b-6.5.x-update_docs-OXDEV-6060
- dev-master-installable-OXDEV-5960
- dev-b-6.4.x
- dev-b-6.5.x_extend_docs
- dev-master-inject_variables-OXDEV-5257
- dev-SPIKE-hide_queries_mutations-OXDEV-4897
- dev-b-6.4.x_patch
- dev-b-6.4.x_graphqlite5
- dev-b-6.3.x
- dev-b-6.2.x
- dev-master-bump_jwt_version
- dev-master-PHP8
- dev-SPIKE-check-usage-of-subject-arg-in-authorization-is-allowed-OXDEV-4551
- dev-OXDEV-4383-graphql_upload-OXDEV-4479
- dev-master-spike_schema_visibility_notifications-OXDEV-4463
- dev-SPIKE-schema_visibility-OXDEV-4449
- dev-master-session_spike-OXDEV-4376
- dev-master-anonymous-spike-OXDEV-4354
- dev-SPIKE-account_schema_documentation
- dev-RESEARCH-hot-to-simplify-schema-script
- dev-SPIKE_codeception_xdebugging-OXDEV-3948
This package is auto-updated.
Last update: 2023-11-04 13:01:23 UTC
README
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
Usage
This assumes you have OXID eShop (at least OXID-eSales/oxideshop_ce: v7.0.0
component, which is part of the 7.0.0
compilation) up and running.
Branch Compatibility
- 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
# Install desired version of oxid-esales/graphql-base module, in this case - latest released 8.x version
$ composer require oxid-esales/graphql-base ^8.0.0
After requiring the module, you need to activate it, either via OXID eShop admin or CLI.
$ ./bin/oe-console oe:module:activate oe_graphql_base
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
query { token ( username: "admin@admin.com", password: "admin" ) }
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.
$ curl http://oxideshop.local/graphql/ \ -H 'Content-Type: application/json' \ --data-binary '{"query":"query {token(username: \"admin@admin.com\", password: \"admin\")}"}'
You should see a response similar to this:
{ "data": { "token": "a-very-long-jwt" } }
This token
is then to be send as your authorization with every request in the
HTTP Authorization
header like this:
Authorization: Bearer a-very-long-jwt
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
$ composer static
Unit/Integration/Acceptance tests
- install this module into a running OXID eShop
- reset shop's database
$ bin/oe-console oe:database:reset --db-host=db-host --db-port=db-port --db-name=db-name --db-user=db-user --db-password=db-password --force
- run Unit/Integration tests
$ ./vendor/bin/phpunit -c vendor/oxid-esales/graphql-base/tests/phpunit.xml
- run Acceptance tests
$ SELENIUM_SERVER_HOST=selenium MODULE_IDS=oe_graphql_base vendor/bin/codecept run acceptance -c vendor/oxid-esales/graphql-base/tests/codeception.yml
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.