Download the PHP package giacocorsiglia/wordpress-stubs without Composer
On this page you can find all versions of the php package giacocorsiglia/wordpress-stubs. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download giacocorsiglia/wordpress-stubs
More information about giacocorsiglia/wordpress-stubs
Files in giacocorsiglia/wordpress-stubs
Package wordpress-stubs
Short Description WordPress function, class, and global variable declaration stubs for easier static analysis.
License GPL-2.0+
Homepage https://github.com/GiacoCorsiglia/wordpress-stubs
Informations about the package wordpress-stubs
‼️ This project is not maintained ‼️
You should use the fork at php-stubs/wordpress-stubs, which is thanks to @szepeviktor.
WordPress Stubs
This package provides stub declarations for WordPress core functions, classes, interfaces, and global variables. These stubs can help plugin and theme developers leverage static analysis tools like Psalm, which often dislike parsing all of WordPress.
The stubs are generated directly from the source using giacocorsiglia/stubs-generator. Needless to say, this library repackages a subset of WordPress code, which is the work of the WordPress core developers. Granted, it's a useless subset without the real thing!
Installation
Require this package as a dev-dependency with Composer:
Alternatively, you may download wordpress-stubs.php
directly.
Usage with Psalm
Update your Psalm config to include the section:
Furthermore, ensure WordPress core code is not included under <projectFiles>
.
Usage for Intellisense
If your editor has trouble parsing all of WordPress, you may find the stubs useful for enabling code completion and related features. For example, here are instructions for usage with VSCode's Intelephense extension. (In my experience, however, Intelephense parses WordPress core just fine.)
Versioning
This package is versioned to match the WordPress version from which the stubs are generated. If any fixes to stubs are required, subsequent releases will be versioned as WP_VERSION.X
.
Generating stubs for a different WordPress version
You should be running PHP 7.1 or later to follow these steps, so any function definitions that are polyfills for older versions of PHP are excluded from the stubs. Additionally, the Stubs Generator package at least requires PHP 7.1.
- Clone this repository and
cd
into it. - Update
"johnpbloch/wordpress": "X.X.X"
incomposer.json
with your desired version. - Run
composer update
- Run
./generate.sh
The wordpress-stubs.php
file should now be updated. Feel free to submit a Pull Request if you'd like to see a release for a newer version. If things have fallen behind, please generate stubs for each missing version in a distinct commit so we can have a continuous release history.
Contributing
Please have a look at CONTRIBUTING.md
.