PHPackages                             thibaud-dauce/phpstan-blade - 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. thibaud-dauce/phpstan-blade

ActiveLibrary

thibaud-dauce/phpstan-blade
===========================

PHPStan extension to analyse Laravel Blade views.

0.5.0(3y ago)2272MITPHP

Since Feb 15Pushed 3y ago1 watchersCompare

[ Source](https://github.com/ThibaudDauce/phpstan-blade)[ Packagist](https://packagist.org/packages/thibaud-dauce/phpstan-blade)[ RSS](/packages/thibaud-dauce-phpstan-blade/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (10)Dependencies (5)Versions (13)Used By (0)

PHPStan Blade
=============

[](#phpstan-blade)

This PHPStan extension analyse Blade views for errors.

[![Result example](https://github.com/ThibaudDauce/phpstan-blade/raw/master/docs/result.png?raw=true)](https://github.com/ThibaudDauce/phpstan-blade/blob/master/docs/result.png?raw=true)

Installation
------------

[](#installation)

Install the extension with Composer.

```
composer require thibaud-dauce/phpstan-blade
```

Add the extension config file to your `phpstan.neon`:

```
includes:
    - ./phpstan-baseline.neon
    - ./vendor/nunomaduro/larastan/extension.neon
    - ./vendor/thibaud-dauce/phpstan-blade/extension.neon

parameters:
    …
```

Add this Composer script to your `composer.json`:

```
{
    "scripts": {
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate"
        ],
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover"
        ],
        "phpstan": [
            "@php artisan phpstan-blade:touch-cache",
            "./vendor/bin/phpstan analyse --error-format blade"
        ]
    },
}
```

Then, you can run `composer phpstan` to touch the cache (see `TouchCacheCommand` comment if you want to know more about why it's required), and run the analyse with the Blade formatter (the Blade formatter is required to allow showing the stacktrace of the views' includes).

Features
--------

[](#features)

- **Analyse `view()` calls**
- **Support Blade directives**
- **Support views namespaces**
- **Support Livewire components**
- **Support `@include` with full stacktrace showing exactly the place and the context of the error**
- Support mailable views
- Support `compact()` function for view parameters

Limitations
-----------

[](#limitations)

### @var docblocks inside Blade views

[](#var-docblocks-inside-blade-views)

If you want to add docblocks to your views to add type information like:

```
@php
    /** @var string */
    $name = config('app.name');
@endphp

{{ $name }}
```

You need to specify the variable name inside the docblock because we add docblocks too between lines so your docblocks will not be right above the assignation.

```
@php
    /** @var string $name */
    $name = config('app.name');
@endphp

{{ $name }}
```

### Constant types (:ConstantTypes)

[](#constant-types-constanttypes)

Right now, if you pass `true` to a view, the type is generalize to `bool` to avoid errors like "If condition is always true.". It could be nice to have a way to raise an error if all `view()` calls pass `true` that the condition is always true. But I think it's hard to implement.

If you pass `['something' => null]` to a view, I transform the type to `mixed` so you may have some errors. You should specify the type for the null value so I can put the correct type information.

```
/** @var ?User */
$user = null;

return view('user', [
    'user' => $user,
]);
```

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

[](#development)

The extension code has a lot of comment to explain every thing it's doing. The main entry point is the `ViewFunctionRule` class.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 98.1% 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 ~33 days

Recently: every ~91 days

Total

12

Last Release

1176d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/33fbc4ff5dd82c3e47432ebe8022eeda6bd167d466a7d9a9638c65e7d92baf81?d=identicon)[ThibaudDauce](/maintainers/ThibaudDauce)

---

Top Contributors

[![ThibaudDauce](https://avatars.githubusercontent.com/u/1770543?v=4)](https://github.com/ThibaudDauce "ThibaudDauce (51 commits)")[![alexander-schranz](https://avatars.githubusercontent.com/u/1698337?v=4)](https://github.com/alexander-schranz "alexander-schranz (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/thibaud-dauce-phpstan-blade/health.svg)

```
[![Health](https://phpackages.com/badges/thibaud-dauce-phpstan-blade/health.svg)](https://phpackages.com/packages/thibaud-dauce-phpstan-blade)
```

###  Alternatives

[knuckleswtf/scribe

Generate API documentation for humans from your Laravel codebase.✍

2.3k12.2M45](/packages/knuckleswtf-scribe)[ssch/typo3-rector

Instant fixes for your TYPO3 PHP code by using Rector.

2592.8M262](/packages/ssch-typo3-rector)[anourvalar/eloquent-serialize

Laravel Query Builder (Eloquent) serialization

11320.2M21](/packages/anourvalar-eloquent-serialize)[rector/rector-src

Instant Upgrade and Automated Refactoring of any PHP code

134391.5k12](/packages/rector-rector-src)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.3k](/packages/blair2004-nexopos)[stillat/proteus

Provides utilities for parsing and updating Laravel-style PHP configuration files.

17287.4k21](/packages/stillat-proteus)

PHPackages © 2026

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