PHPackages er1z/graphql\_accelerator - 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. er1z/graphql\_accelerator ActivePhp-ext[API Development](/categories/api) er1z/graphql\_accelerator ========================= Native GraphQL parser accelerator for webonyx/graphql-php v0.1.4(2w ago)022MITRustPHP >=8.1CI passing Since May 27Pushed 2w agoCompare [ Source](https://github.com/er1z/graphql-php-accelerator)[ Packagist](https://packagist.org/packages/er1z/graphql_accelerator)[ RSS](/packages/er1z-graphql-accelerator/feed)WikiDiscussions master Synced 1w ago READMEChangelog (6)DependenciesVersions (8)Used By (0) graphql\_accelerator ==================== [](#graphql_accelerator) PHP extension to accellerate GraphQL parser of `webonyx/graphql-php`. Written in Rust on top of [`apollo-parser`](https://crates.io/crates/apollo-parser) and [`ext-php-rs`](https://crates.io/crates/ext-php-rs). Why --- [](#why) PHP is not the most efficient technology on parsing ASTs at a good performance. During the work on the application that heavily uses the GraphQL server. Unfortunately, our current workflow makes usage of stored queries a challenge, so came across the idea of leveraging query parsing to more performant technology How it works ------------ [](#how-it-works) As the original GraphQL PHP parser call is hardcoded, I decided not to fork the library and add something to the parser. Instead, this extension injects an extension-based parser to the PHP classes runtime to skip autoloading of the original ones. So, the only task to be done is to add the module to your PHP installation. All the batteries are already included. This approach has some limitations, but based on my benchmarks, it's the most performant. Initially, I started with a fork of PHP libgraphqlparser wrapper, but the original C library is unmaintained, so not all features were available. Using apollo-parser provides predictive stability, and – what surprised me – offered way better performance. Disclaimer ---------- [](#disclaimer) This extension is not production-ready, and you are responsible for any damage caused by using it. It was built as a challenge, yet I will try to use it by myself where applicable. Also, the codebase was built by AI-vibing but with making sure all the good software craftsmanship principles are still followed, so: - all known memory leaks are covered - development was focused on verifying if new logic keeps original unit tests still to be successful - this project was published once it started to bring at least noticeable benefits Outcomes -------- [](#outcomes) `benchmark-native.php` reports a **geomean 11–16× speedup** across 8 query sizes (range 7.4×–20.9×). Full per-section results — latency, location cost, memory, throughput, synthetic stress, partial parsers — are in [`benchmarks/RESULTS.md`](../benchmarks/RESULTS.md). Requirements ------------ [](#requirements) - Linux/MacOS (Windows is **not** supported, if you're eager to prepare the pipeline, feel free to make a PR) - PHP 8.1+ - libc runtime (didn't test with others like musl) - Rust 1.88+ for building (not needed for a runtime) Installation ------------ [](#installation) ### Prerequisites [](#prerequisites) Make sure you have configured PHP with sources and available `cargo` + `rustc`. Minimum version is `1.88` so if you are under Debian Trixie, use backports repository to get an actual cargo version: ``` # edit /etc/apt/sources.list.d to add backports: https://backports.debian.org/Instructions/ apt-get update apt-get install -t backports cargo ``` ### Recommended: PIE installation [](#recommended-pie-installation) If you have [PIE](https://github.com/php/pie), then the installation is pretty straightforward: ``` pie install er1z/graphql_accelerator ``` ### Manual installation from sources [](#manual-installation-from-sources) Clone the repository and then use a standard PHP extensions installation: ``` phpize ./configure make make install ``` ### Manual installation from binaries [](#manual-installation-from-binaries) There are Linux amd64 binaries available on Releases page. What's done ----------- [](#whats-done) - 53 native PHP class entries: `Source`, `SourceLocation`, `Location`, `DirectiveLocation`, `Node`, 43 concrete AST nodes, 10 marker interfaces, and `Parser`. (`Token`, `Lexer`, `NodeKind`, and `NodeList` autoload from the on-disk PHP files — they hit non-hot code paths.) - `` → … → `` `Token` chain materialised on the document's `Location` (comments included, whitespace and commas skipped), built from a single re-lex pass over the source via apollo's `Lexer`. - `Parser::parse`, `Parser::parseValue`, `Parser::parseType`, and 17 `__callStatic` partial parsers (`name`, `argumentsDefinition`, `directiveLocations`, `implementsInterfaces`, `unionMemberTypes`, …). - Native handling for `noLocation`, `allowLegacySDLEmptyFields`, `allowLegacySDLImplementsInterfaces`, `experimentalFragmentVariables`, and `recursionLimit` options. - Block-string parsing with the `\"""` → `"""` spec escape. - `Node::__construct`/`__toString`/`toArray`/`jsonSerialize`/`cloneDeep`/ `getName`, `Location::create`/`toArray`, `Source::getLocation`, `SourceLocation::jsonSerialize` all implemented in Rust. - `SyntaxError` thrown via `PhpException::new` + scoped `zend_update_property` for the inherited `Error` typed properties. - 7 phpt smoke tests in `tests/phpt/` (extension loads, all expected classes/interfaces registered, constants correct, property order matches the PHP source, `Parser::parse` parses end-to-end, instanceof graph parity, no AST autoload triggered). Build ----- [](#build) ``` cd ext cargo build --release # → target/release/libgraphql_accelerator.so ``` Requires: - PHP 8.1+ with header files (`php-config --includes`) - Rust 1.95+ - `libclang-dev` (pulled in by `ext-php-rs-bindgen`) Testing ------- [](#testing) ### Smoke-load [](#smoke-load) ``` php -d extension=$(pwd)/target/release/libgraphql_accelerator.so \ -r 'var_dump(extension_loaded("graphql_accelerator"));' # bool(true) ``` ### Run the extension-local phpt suite [](#run-the-extension-local-phpt-suite) ``` TEST_PHP_EXECUTABLE=$(which php) \ php $(php -r 'echo PHP_BINDIR;')/../lib/php/build/run-tests.php \ -d "extension=$(pwd)/target/release/libgraphql_accelerator.so" \ -q tests/phpt/ # Tests passed : 7 (100.0%) ``` ### Run the project's PHPUnit Language suite [](#run-the-projects-phpunit-language-suite) ``` cd graphql-php php -d extension=$(pwd)/../ext/target/release/libgraphql_accelerator.so \ vendor/bin/phpunit tests/Language/ --no-progress # Tests: 227, Assertions: 14299, Skipped: 2 (100% effective pass) ``` ### Benchmark [](#benchmark) ``` cd .. php benchmark-native.php $(pwd)/ext/target/release/libgraphql_accelerator.so ``` Layout ------ [](#layout) ``` ext/ ├── Cargo.toml crate name = "graphql_accelerator" ├── Cargo.lock ├── build.rs empty — placeholder for cargo-php hook-up ├── rust-toolchain.toml pins MSRV to 1.95 ├── src/ │ ├── lib.rs #[php_module] entry, MINIT wiring │ ├── options.rs ParserOptions │ ├── source.rs Source coercion / construction │ ├── tokens.rs … Token-chain builder │ ├── errors.rs apollo-parser error → graphql-php SyntaxError mapper │ ├── classes/ │ │ ├── mod.rs ClassProperty helpers, JsonSerializable shim │ │ ├── slots.rs per-class static slots & ClassEntryInfo getters │ │ ├── support.rs SourceLocation, Source, DirectiveLocation, Location │ │ ├── interfaces.rs 10 marker interfaces │ │ ├── nodes.rs Node + 43 concrete AST node classes │ │ └── parser.rs Parser + __callStatic dispatch │ └── lower/ │ ├── mod.rs document/value/type entry points │ ├── ctx.rs LowerCtx (line table, source zv, options) │ ├── helpers.rs ZBoxObj builder, NodeList construction │ ├── values.rs value-literal lowering + block-string decode │ ├── types.rs type-reference lowering │ ├── selections.rs operation/fragment/field lowering │ └── sdl.rs SDL definition + extension lowering └── tests/ └── phpt/ extension-local smoke tests ``` ### Health Score 39 — LowBetter than 84% of packages Maintenance96 Actively maintained with recent releases Popularity8 Limited adoption so far Community8 Small or concentrated contributor base Maturity37 Early-stage or recently created project Bus Factor1 Top contributor holds 91.7% 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 ~8 days Total 6 Last Release 17d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1813302?v=4)[Przemysław eRIZ Pawliczuk](/maintainers/er1z)[@er1z](https://github.com/er1z) --- Top Contributors [![er1z](https://avatars.githubusercontent.com/u/1813302?v=4)](https://github.com/er1z "er1z (11 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)") ### Embed Badge ![Health badge](/badges/er1z-graphql-accelerator/health.svg) ``` [![Health](https://phpackages.com/badges/er1z-graphql-accelerator/health.svg)](https://phpackages.com/packages/er1z-graphql-accelerator) ``` ### Alternatives [exsyst/swagger A php library to manipulate Swagger specifications 35916.4M7](/packages/exsyst-swagger)[hubspot/api-client Hubspot API client 24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol An implementation of the Minecraft: Bedrock Edition protocol in PHP 172445.0k18](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram Telegram driver for BotMan 93459.5k6](/packages/botman-driver-telegram) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)