README

PHP stub declarations for the Fluent Cart plugin, for IDE completion and static analysis. Generated with php-stubs/generator directly from the plugin source.

Generated from Fluent Cart 1.6.0 — 715 classes · 11 interfaces · 21 traits · 15 functions · 8 constants.

🚀 Features

Complete class, interface, trait and function declarations
Constants in a separate file, so PHPStan can scan them rather than analyse them
IDE autocompletion for a plugin that is not a Composer dependency
Reproducible: the source is downloaded from WordPress.org, never vendored

📋 Requirements

PHP >= 7.4
Composer

📦 Installation

composer require --dev mralaminahamed/fluent-cart-stubs

Or download the stub files directly:

🔧 Configuration

Add both files to PHPStan. scanFiles rather than bootstrapFiles: the stubs declare symbols for analysis, they are not meant to be executed.

parameters:
    scanFiles:
        - vendor/mralaminahamed/fluent-cart-stubs/fluent-cart-stubs.stub
        - vendor/mralaminahamed/fluent-cart-stubs/fluent-cart-constants-stubs.stub

For IDE completion, point your IDE at the same files — in PhpStorm, mark them as an Include Path rather than a source root, so the empty method bodies never shadow the real plugin.

🔍 Quick usage example

<?php
$order = \FluentCart\App\Models\Order::find( $order_id );
$total = $order->total_amount; // cents, as Fluent Cart stores it

if ( defined( 'FLUENTCART_VERSION' ) ) {
    // Your implementation
}

⚠️ Limitations

Stubs are a snapshot. They describe Fluent Cart 1.6.0. Regenerate when the plugin changes a signature, or pin the stub version alongside the plugin version you support.
Method bodies are empty by design. PHPStan reads declarations and types; it never needs the implementation. Do not load these files at runtime.
Only top-level constants are captured. All eight of its top-level constants are captured. A constant defined inside a function or method is invisible to any stub generator; declare those in your own bootstrapFiles, or list them under PHPStan's dynamicConstantNames.

🔄 Regenerating

composer install
composer generate          # reads source/fluent-cart, writes both .stub files
composer release           # tag a new version for each untagged upstream release

bin/generate.sh expects the plugin unpacked at source/fluent-cart; bin/release-latest-versions.sh downloads each version from WordPress.org and tags it. Sources are gitignored — the repository carries stubs, not a copy of the plugin.

The finder reads app/, boot/, api/ and vendor/wpfluent/framework/src. That last one is not an oversight: the WPFluent framework is namespaced into FluentCart\Framework, which makes it part of Fluent Cart's own API — every model extends its ORM base, and Order::query() resolves through that base's __callStatic. Leave it out and every model call reads as undefined. The rest of vendor/, along with assets, templates and language files, is excluded.

📁 Package structure

phpstan-fluent-cart-stubs/
├── bin/                              # generate.sh, release scripts
├── configs/                          # finder.php (what to read), bootstrap.php (WP constants)
├── source/                           # plugin source, gitignored
├── tests/                            # smoke tests over the generated stubs
├── fluent-cart-stubs.stub               # classes, interfaces, traits, functions
├── fluent-cart-constants-stubs.stub     # constants only
└── phpstan.neon                      # analyses the stubs themselves

📝 License

The tooling in this repository is MIT. The generated stubs are derived from Fluent Cart, which is GPL-licensed; using them for static analysis is fair use of the declarations, but redistributing them as your own product is not. See LICENSE.

mralaminahamed / fluent-cart-stubs

Maintainers

Package info

Statistics

Security