Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/graphpql/graphpinator
:zap::globe_with_meridians::zap: Easy-to-use & Fast GraphQL server implementation for modern PHP. Includes features from latest draft, middleware directives and modules with extra functionality.
https://github.com/graphpql/graphpinator
api api-server graphql graphql-php graphql-server php
Last synced: 9 days ago
JSON representation
:zap::globe_with_meridians::zap: Easy-to-use & Fast GraphQL server implementation for modern PHP. Includes features from latest draft, middleware directives and modules with extra functionality.
- Host: GitHub
- URL: https://github.com/graphpql/graphpinator
- Owner: graphpql
- License: mit
- Created: 2020-03-22T22:55:10.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-04-22T18:51:46.000Z (7 months ago)
- Last Synced: 2024-04-24T03:18:05.103Z (7 months ago)
- Topics: api, api-server, graphql, graphql-php, graphql-server, php
- Language: PHP
- Homepage: https://github.com/graphpql
- Size: 2.88 MB
- Stars: 38
- Watchers: 3
- Forks: 8
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: docs/supporters/webthinx.png
Awesome Lists containing this project
- awesome-graphql - GraPHPinator - Easy-to-use GraphQL server implementation for modern PHP. (Libraries / PHP Libraries)
README
# GraPHPinator [](https://github.com/graphpql/graphpinator/actions/workflows/php.yml) [](https://codecov.io/gh/infinityloop-dev/graphpinator)
:zap::globe_with_meridians::zap: Easy-to-use & Fast GraphQL server implementation for PHP.
## Introduction
Feature complete PHP implementation of GraphQL server. Its job is transformation of query string into resolved Json result for a given Schema.
- Aims to be compliant with the **latest draft of GraphQL specification** and its RFCs.
- Fully typesafe, and therefore **minimum required PHP version is 8.1**. Sacrifices a tiny bit of convenience for huge amount of clarity and safety - no random configuration `array`s, no mixed types, no variable function arguments - this library doesnt try to save you from verbosity, but makes sure you always know what you've got.
- **Code first**.
- Flexible. Easy to extend with extra functionality using **Modules** or **middleware Directives**.
- Includes some **opt-in extensions** which are out of scope of official specs:
|Name|Version|Description|
|---|---|---|
|[Printer](https://github.com/graphpql/graphpinator-printer)||Schema printing for GraPHPinator typesystem.|
|[Extra types](https://github.com/graphpql/graphpinator-extra-types)||Some useful directives and commonly used types, both scalar or composite.|
|[Constraint directives](https://github.com/graphpql/graphpinator-constraint-directives)||Typesystem directives to declare additional validation on top of GraphQL typesystem.|
|[Where directives](https://github.com/graphpql/graphpinator-where-directives)||Executable directives to filter values in lists.|
|[Upload](https://github.com/graphpql/graphpinator-upload)||Module to handle [multipart-formdata](https://github.com/jaydenseric/graphql-multipart-request-spec) requests.|
|[Query cost](https://github.com/graphpql/graphpinator-query-cost)||Modules to limit query cost by restricting maximum depth or number of nodes.|
|[Persisted queries](https://github.com/graphpql/graphpinator-persisted-queries)||Module to persist validated query in cache and improve performace of repeating queries.|
- Includes adapters for easy integration into other PHP frameworks:
|Name|Version|Description|
|---|---|---|
|PSR|Bundled||
|[Symfony](https://github.com/graphpql/graphpinator-symfony)||Adapters for [Symfony framework](https://symfony.com/).|
|[Nette](https://github.com/graphpql/graphpinator-nette)||Adapters for [Nette framework](https://nette.org/).|
- Project is composed of multiple smaller packages, which may be used standalone:
|Name|Version|Description|
|---|---|---|
|[Source](https://github.com/graphpql/graphpinator-source)||Wrapper around source document.|
|[Tokenizer](https://github.com/graphpql/graphpinator-tokenizer)||Lexical analyzer of GraphQL document.|
|[Parser](https://github.com/graphpql/graphpinator-parser)||Syntactic analyzer of GraphQL document.|
## Supporters
This project is being made with help by following companies and individuals. Thank you!
[](https://www.webthinx.com/)
## Installation
Install package using composer
```composer require infinityloop-dev/graphpinator```
## How to use
- Visit our simple [Hello world example](/docs/examples/HelloWorld.md).
- Or visit [the complete Docs](/docs/README.md).
## Dependencies
- PHP 8.1+
- Latest PHP 8.0+ version is 1.3.x
- Latest PHP 7.4+ version is 0.25.x
- [psr/http-message](https://github.com/php-fig/http-message)
- [psr/log](https://github.com/php-fig/log)
This list excludes graphpinator sub-packages such as graphpinator-common, graphpinator-tokenizer and others.
## Contributing
This package is relatively new, so some features might be missing. If you stumble upon something that is not included or is not compliant with the specs, please inform us by creating an issue or discussion. This is not yet another package, where issues and pull-requests lie around for months, so dont hesitate and help us improve the library.