php-stubs/wordpress-stubs

WordPress function and class declaration stubs for static analysis.

v6.6.2 2024-09-30 07:10 UTC

Requires (Dev)

• php: ^7.4 || ^8.0
• dealerdirect/phpcodesniffer-composer-installer: ^1.0
• nikic/php-parser: ^4.13
• php-stubs/generator: ^0.8.3
• phpdocumentor/reflection-docblock: ^5.4.1
• phpstan/phpstan: ^1.10.49
• phpunit/phpunit: ^9.5
• szepeviktor/phpcs-psr-12-neutron-hybrid-ruleset: ^1.0
• wp-coding-standards/wpcs: 3.1.0 as 2.3.0

Suggests

• paragonie/sodium_compat: Pure PHP implementation of libsodium
• symfony/polyfill-php80: Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions
• szepeviktor/phpstan-wordpress: WordPress extensions for PHPStan

MIT

• wordpress
• static analysis
• PHPStan

README

Important

Hello everyone! This is Viktor who runs the php-stubs organization. I am planning to stop contributing to the WordPress ecosystem because it is extremely difficult and I do not earn (min) €100/month.

Please support my work to avoid abandoning this package.

Thank you!

WordPress Stubs

It provides stub declarations for WordPress core functions, classes and interfaces, globals are not included. These stubs can help plugin and theme developers leverage static analysis tools like PHPStan.

The stubs are generated from @johnpbloch's package using php-stubs/generator.

Requirements

• PHP 7.4 or 8.0

Installation

Require this package as a development dependency with Composer.

composer require --dev php-stubs/wordpress-stubs

Alternatively you may download wordpress-stubs.php directly.

Usage with PHPStan

composer require --dev szepeviktor/phpstan-wordpress

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

Usage with Psalm

Update your Psalm config to include this section.

<stubs>
    <file name="vendor/php-stubs/wordpress-stubs/wordpress-stubs.php" />
</stubs>

Furthermore ensure WordPress core is not included in <projectFiles>.

Usage in Intellisense

If your IDE has trouble parsing all of WordPress you may find the stubs useful for enabling code completion and related features. For example there are instructions for usage with VSCode's Intelephense extension.

Versioning

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

Generating stubs for a different WordPress version

1. Run modern PHP version
2. Clone this repository and cd into it
3. Update "johnpbloch/wordpress": "x.x.x" in source/composer.json with the desired version
4. Run composer update
5. And run ./generate.sh

The wordpress-stubs.php file should now be updated.