PHPackages                             aazbeltran/laravel-backpack-phpstan-extension - 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. [Admin Panels](/categories/admin)
4. /
5. aazbeltran/laravel-backpack-phpstan-extension

ActivePhpstan-extension[Admin Panels](/categories/admin)

aazbeltran/laravel-backpack-phpstan-extension
=============================================

PHPStan extension for Laravel Backpack - Adds static analysis support for Backpack CRUD, Basset, and other Backpack components

v1.0.1(9mo ago)0163MITPHPPHP ^8.1|^8.2|^8.3CI failing

Since Aug 29Pushed 9mo agoCompare

[ Source](https://github.com/aazbeltran/laravel-backpack-phpstan-extension)[ Packagist](https://packagist.org/packages/aazbeltran/laravel-backpack-phpstan-extension)[ RSS](/packages/aazbeltran-laravel-backpack-phpstan-extension/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (6)Versions (4)Used By (0)

Laravel Backpack PHPStan Extension
==================================

[](#laravel-backpack-phpstan-extension)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a40b0ba912c8e084339b6cd085c853e67455a885f3a6e3815f6a88683d7c5335/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f61617a62656c7472616e2f6c61726176656c2d6261636b7061636b2d7068707374616e2d657874656e73696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aazbeltran/laravel-backpack-phpstan-extension)[![GitHub Tests Action Status](https://camo.githubusercontent.com/5eb58a1dc67f5ffed027a19411178495187cef0135ffd331d95e129b3296eb41/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f61617a62656c7472616e2f6c61726176656c2d6261636b7061636b2d7068707374616e2d657874656e73696f6e2f63692e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/aazbeltran/laravel-backpack-phpstan-extension/actions?query=workflow%3Aci+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/22d5928efe147cf54a007f8f14f232df0e5293f5014166af8963d77419f25eca/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f61617a62656c7472616e2f6c61726176656c2d6261636b7061636b2d7068707374616e2d657874656e73696f6e2f63692e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/aazbeltran/laravel-backpack-phpstan-extension/actions?query=workflow%3Aci+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/5235d6bea64db5bedaca21e54be8a0a5a6ba7196d67fab8b58d643756c0c0bdc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f61617a62656c7472616e2f6c61726176656c2d6261636b7061636b2d7068707374616e2d657874656e73696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aazbeltran/laravel-backpack-phpstan-extension)

**Comprehensive PHPStan support for Laravel Backpack CRUD with Pro package compatibility**

*Make your Backpack applications statically analyzable and improve code quality with zero configuration*

---

✨ Features
----------

[](#-features)

🔮 **Magic Method Resolution** - Automatically resolves dynamic methods on CrudField and CrudColumn classes
⛓️ **Fluent Interface Support** - Maintains proper return types for seamless method chaining
💎 **Pro Package Ready** - Full compatibility with Backpack Pro operations and advanced features
🏗️ **Laravel Facades** - Complete type hints for Laravel facades used throughout Backpack
📚 **Comprehensive Stubs** - Type definitions for all major Backpack classes and components
🚀 **Zero Configuration** - Works out of the box with sensible defaults

🚀 Quick Start
-------------

[](#-quick-start)

### Installation

[](#installation)

```
composer require --dev aazbeltran/laravel-backpack-phpstan-extension
```

### Configuration

[](#configuration)

Add to your `phpstan.neon`:

```
includes:
    - vendor/aazbeltran/laravel-backpack-phpstan-extension/extension.neon
```

### Run Analysis

[](#run-analysis)

```
vendor/bin/phpstan analyse
```

That's it! 🎉 Your Backpack code is now statically analyzed.

📖 Usage Examples
----------------

[](#-usage-examples)

### Before: PHPStan Errors ❌

[](#before-phpstan-errors-)

```
// PHPStan errors: Unknown methods, undefined properties
$this->crud->addField(['name' => 'title', 'type' => 'text'])
          ->removeField('slug')
          ->modifyField('content', ['type' => 'wysiwyg']);

$this->crud->addColumn(['name' => 'status', 'type' => 'select'])
          ->removeColumn('internal_notes')
          ->modifyColumn('created_at', ['type' => 'datetime']);
```

### After: Clean Analysis ✅

[](#after-clean-analysis-)

```
// PHPStan understands the fluent interface and method chaining
$this->crud->addField(['name' => 'title', 'type' => 'text'])
          ->removeField('slug')                    // ✅ Method resolved
          ->modifyField('content', ['type' => 'wysiwyg']); // ✅ Return type maintained

$this->crud->addColumn(['name' => 'status', 'type' => 'select'])
          ->removeColumn('internal_notes')        // ✅ Method resolved
          ->modifyColumn('created_at', ['type' => 'datetime']); // ✅ Fluent interface
```

### Pro Package Support

[](#pro-package-support)

```
// Pro operations work seamlessly
use Backpack\Pro\Http\Controllers\Operations\CloneOperation;
use Backpack\Pro\Http\Controllers\Operations\FetchOperation;

class ArticleCrudController extends CrudController
{
    use CloneOperation, FetchOperation; // ✅ Traits properly typed

    public function setup()
    {
        $this->crud->setModel(Article::class);
        $this->crud->setRoute('admin/article');
        $this->crud->clone();  // ✅ Pro method resolved
        $this->crud->fetch();  // ✅ Pro method resolved
    }
}
```

🎯 Supported Components
----------------------

[](#-supported-components)

**Core CRUD Features**- ✅ **CrudPanel** - Main panel operations and configuration
- ✅ **CrudField** - Field definitions with fluent interface
- ✅ **CrudColumn** - Column definitions with fluent interface
- ✅ **CrudFilter** - Filter definitions and logic
- ✅ **CrudButton** - Button definitions and positioning
- ✅ **Widget** - Dashboard and page widgets
- ✅ **CrudController** - Base controller functionality
- ✅ **CrudPanelFacade** - Static facade access

**Pro Package Features**- ✅ **CloneOperation** - Entity cloning functionality
- ✅ **FetchOperation** - AJAX data fetching
- ✅ **InlineCreateOperation** - Inline entity creation
- ✅ **ChartController** - Dashboard charts and analytics
- ✅ **Pro Fields** - Advanced field types
- ✅ **Pro Widgets** - Enhanced widget components

**Laravel Integration**- ✅ **Facades** - Route, Auth, Request, Schema, etc.
- ✅ **Eloquent Models** - Enhanced model typing
- ✅ **Request/Response** - HTTP layer improvements
- ✅ **Validation** - Custom rule definitions

⚠️ Version Compatibility
------------------------

[](#️-version-compatibility)

> **Important Notice**: This extension was developed and tested against specific versions of Laravel Backpack packages. Compatibility with other versions is not guaranteed.

### Tested Versions

[](#tested-versions)

- **Laravel Backpack CRUD**: `^6.0`
- **Laravel Backpack Pro**: `^2.0` (optional)
- **Laravel**: `^10.0|^11.0`
- **PHP**: `^8.1`
- **PHPStan**: `^1.10|^2.0`

### Maintenance Notice

[](#maintenance-notice)

⚠️ **Limited Maintenance**: Due to the lack of access to Backpack Pro licenses for all contributors, this extension has limited long-term maintenance plans. Community contributions are encouraged and appreciated.

For the most up-to-date compatibility information, please check our [compatibility matrix](COMPATIBILITY.md).

🧪 Testing
---------

[](#-testing)

Run the test suite:

```
composer test
```

Run PHPStan analysis on the extension itself:

```
composer analyse
```

Run code style fixes:

```
composer format
```

📊 Error Reduction Results
-------------------------

[](#-error-reduction-results)

Based on real-world testing with Laravel Backpack codebases:

- **Before**: 655+ PHPStan errors
- **After**: 98 errors resolved (15% improvement)
- **Key fixes**: Magic methods, property access, Pro compatibility

🔧 Advanced Configuration
------------------------

[](#-advanced-configuration)

### Custom Stub Paths

[](#custom-stub-paths)

```
# phpstan.neon
includes:
    - vendor/aazbeltran/laravel-backpack-phpstan-extension/extension.neon

parameters:
    backpackExtension:
        additionalStubs:
            - path/to/your/custom-stubs.php
```

### Selective Feature Enabling

[](#selective-feature-enabling)

```
parameters:
    backpackExtension:
        enabledFeatures:
            - crud_fields      # Enable CrudField magic methods
            - crud_columns     # Enable CrudColumn magic methods
            - pro_operations   # Enable Pro operation support
            - laravel_facades  # Enable Laravel facade stubs
```

🤝 Contributing
--------------

[](#-contributing)

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

### Quick Development Setup

[](#quick-development-setup)

```
git clone https://github.com/aazbeltran/laravel-backpack-phpstan-extension.git
cd laravel-backpack-phpstan-extension
composer install
composer test
```

For AI agents and automated tools, see [AGENTS.md](AGENTS.md) for detailed development instructions.

📚 Documentation
---------------

[](#-documentation)

- [Installation Guide](docs/installation.md)
- [Configuration Options](docs/configuration.md)
- [Troubleshooting](docs/troubleshooting.md)
- [Compatibility Matrix](COMPATIBILITY.md)
- [API Reference](docs/api-reference.md)

🆘 Support
---------

[](#-support)

- 📖 **Documentation**: [https://github.com/aazbeltran/laravel-backpack-phpstan-extension/docs](docs/)
- 🐛 **Issues**: [GitHub Issues](https://github.com/aazbeltran/laravel-backpack-phpstan-extension/issues)
- 💬 **Discussions**: [GitHub Discussions](https://github.com/aazbeltran/laravel-backpack-phpstan-extension/discussions)
- 💡 **Feature Requests**: [Feature Request Template](https://github.com/aazbeltran/laravel-backpack-phpstan-extension/issues/new?template=feature_request.md)

📃 License
---------

[](#-license)

This package is open-sourced software licensed under the [MIT license](LICENSE.md).

🙏 Credits
---------

[](#-credits)

- **Laravel Backpack Team** - For creating an amazing admin panel package
- **PHPStan Team** - For providing excellent static analysis tools
- **Community Contributors** - For reporting issues and suggesting improvements

---

**Made with ❤️ for the Laravel Backpack community**

[⭐ Star this repo](https://github.com/aazbeltran/laravel-backpack-phpstan-extension) | [🐦 Follow on Twitter](https://twitter.com/BackpackForLaravel) | [📱 Join Discord](https://discord.gg/backpack)

Supported Classes
-----------------

[](#supported-classes)

- `CrudPanel` - Main CRUD panel functionality
- `CrudField` - Form field configuration
- `CrudColumn` - Column configuration for list views
- `CrudFilter` - Filter configuration
- `CrudController` - Base CRUD controller
- `Widget` - Widget system
- Facades (CRUD facade support)

Error Reduction
---------------

[](#error-reduction)

This extension helps eliminate common PHPStan errors when working with Laravel Backpack:

### Before (with errors):

[](#before-with-errors)

```
Call to an undefined method Backpack\CRUD\app\Library\CrudPanel\CrudField::type()
Call to an undefined method Backpack\CRUD\app\Library\CrudPanel\CrudField::required()

```

### After (no errors):

[](#after-no-errors)

```
CRUD::field('name')->type('text')->required(); // ✅ All methods recognized
```

Development
-----------

[](#development)

### Running Tests

[](#running-tests)

```
composer test
```

### Running PHPStan Analysis

[](#running-phpstan-analysis)

```
composer analyse
```

Requirements
------------

[](#requirements)

- PHP 8.1+
- PHPStan ^1.10 or ^2.0
- Laravel Backpack CRUD ^6.0

Supported Backpack Packages
---------------------------

[](#supported-backpack-packages)

- [Backpack CRUD](https://backpackforlaravel.com/docs/6.x/crud-tutorial) ^6.0
- [Backpack Basset](https://github.com/Laravel-Backpack/basset) ^1.0
- [Backpack Pro](https://backpackforlaravel.com/products/pro-for-unlimited-projects) (optional)

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

Contributing
------------

[](#contributing)

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for release history.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance55

Moderate activity, may be stable

Popularity13

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

2

Last Release

298d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3081a499443e911c56aad48b16617baf3be05dac0d49983528a28e26a19e7458?d=identicon)[aazbeltran](/maintainers/aazbeltran)

---

Top Contributors

[![aazbeltran](https://avatars.githubusercontent.com/u/7277106?v=4)](https://github.com/aazbeltran "aazbeltran (14 commits)")

---

Tags

phpPHPStanlaravelstatic analysisextensioncrudbackpacktype-checking

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/aazbeltran-laravel-backpack-phpstan-extension/health.svg)

```
[![Health](https://phpackages.com/badges/aazbeltran-laravel-backpack-phpstan-extension/health.svg)](https://phpackages.com/packages/aazbeltran-laravel-backpack-phpstan-extension)
```

###  Alternatives

[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k51.0M7.6k](/packages/larastan-larastan)[calebdw/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

15104.9k4](/packages/calebdw-larastan)[novius/laravel-backpack-crud-extended

This package extends Laravel Backpack\\CRUD

589.1k2](/packages/novius-laravel-backpack-crud-extended)[inani/nova-resource-maker

A Laravel Nova package to help you generate resources fields

2413.7k](/packages/inani-nova-resource-maker)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)