AxeWP / wp-graphql-stubs

Provides stub declarations for WPGraphQL core functions, classes and interfaces.
MIT License
7 stars 1 forks source link
hacktoberfest hacktoberfest2023 php-stubs wordpress wp-graphql wpgraphql

WPGraphQL Stubs

Provides stub declarations for WPGraphQL core functions, classes and interfaces. These stubs can help plugin and theme developers leverage static analysis tools like PHPStan.

The stubs are generated with php-stubs/generator.

Requirements

Installation

Require this package as a development dependency with Composer.

composer require --dev axepress/wp-graphql-stubs

Alternatively you may download wp-graphql-stubs.php directly.

Usage with PHPStan

composer require --dev szepeviktor/phpstan-wordpress axepress/wp-graphql-stubs

The package szepeviktor/phpstan-wordpress depends on phpstan/phpstan. Please do read that package's README and see the example directory over there.

Versioning

This package is versioned to match the WPGraphQL version from which the stubs are generated.

When changes are made to the actual stub generation that require a new release, the old release is deleted and a new tag is created with the format x.x.x+repack.y where x.x.x is the WPGraphQL version and y is the the repack iteration. This is necessary because Composer's SemVer implementation ignores build meta when determining the latest version.

If you already have an old build of the version installed, you will need to run composer update --no-cache to get the latest repack.

Generating stubs for a different WPGraphQL version

  1. Clone this repository and cd into it.
  2. Update "wpackagist-plugin/wp-graphql": "x.x.x" in composer.json with the desired version
  3. Run composer update
  4. Run composer generate

The wp-graphql-stubs.php file should now be updated.

Prior Art