PHPackages                             be-framework/psalm-plugin - 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. [Testing & Quality](/categories/testing)
4. /
5. be-framework/psalm-plugin

ActivePsalm-plugin[Testing & Quality](/categories/testing)

be-framework/psalm-plugin
=========================

Psalm plugin that detects Be Framework runtime errors at static-analysis time

1.x-dev(3w ago)084[1 issues](https://github.com/be-framework/psalm-plugin/issues)[2 PRs](https://github.com/be-framework/psalm-plugin/pulls)1MITPHPPHP ^8.3

Since May 16Pushed yesterdayCompare

[ Source](https://github.com/be-framework/psalm-plugin)[ Packagist](https://packagist.org/packages/be-framework/psalm-plugin)[ RSS](/packages/be-framework-psalm-plugin/feed)WikiDiscussions 1.x Synced 1w ago

READMEChangelogDependencies (6)Versions (3)Used By (1)

be-framework/psalm-plugin
=========================

[](#be-frameworkpsalm-plugin)

[![Test](https://github.com/be-framework/psalm-plugin/actions/workflows/test.yml/badge.svg)](https://github.com/be-framework/psalm-plugin/actions/workflows/test.yml)

Psalm plugin that detects [Be Framework](https://github.com/be-framework/Be.Framework) runtime errors at static-analysis time.

What it detects
---------------

[](#what-it-detects)

### `MissingBeingParameterAttribute`

[](#missingbeingparameterattribute)

A Being class constructor parameter that lacks both `#[Input]` (`Ray\InputQuery\Attribute\Input`) and `#[Inject]` (`Ray\Di\Di\Inject`). At runtime this raises `Be\Framework\Exception\MissingParameterAttribute` from `BecomingArguments`.

```
final readonly class WeightLogged
{
    public function __construct(
        #[Input] public string $recordedAt,
        public StorageInterface $storage, // ← missing attribute, reported
    ) {}
}
```

A class is treated as a Being when its constructor declares at least one `#[Input]` parameter.

### `ConflictingBeingParameterAttribute`

[](#conflictingbeingparameterattribute)

A Being constructor parameter that carries **both** `#[Input]` and `#[Inject]`. At runtime this raises a conflict error from `BecomingArguments`.

```
public function __construct(
    #[Input, Inject] public StorageInterface $storage, // ← reported
) {}
```

### `InvalidValidateException`

[](#invalidvalidateexception)

A `#[Validate]` method that throws an exception not extending `\DomainException`. `Be\Framework\SemanticVariable\SemanticValidator` only catches `DomainException`, so other types silently bypass validation.

```
#[Validate]
public function validate(string $value): void
{
    if ($value === '') {
        throw new \RuntimeException('empty'); // ← reported
    }
}
```

Variable throws and ternary/match unions are resolved via Psalm's `NodeTypeProvider`. When the type cannot be resolved, the plugin stays silent (false-positive avoidance).

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

[](#installation)

```
composer require --dev be-framework/psalm-plugin
```

Register the plugin in your `psalm.xml`:

```

```

Or use the Psalm plugin installer:

```
vendor/bin/psalm-plugin enable be-framework/psalm-plugin
```

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

[](#requirements)

- PHP 8.3+
- Psalm 6.x

Suppressing issues
------------------

[](#suppressing-issues)

Standard Psalm suppression works at the class or method level:

```
/** @psalm-suppress MissingBeingParameterAttribute */
final readonly class IntentionallyLoose
{
    // ...
}
```

License
-------

[](#license)

MIT

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance98

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

25d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/db4fc75ffc631168d0d7143b6f2c24b1534dfb921212bd851c026c5cbbb1344d?d=identicon)[koriym](/maintainers/koriym)

---

Top Contributors

[![koriym](https://avatars.githubusercontent.com/u/529021?v=4)](https://github.com/koriym "koriym (1 commits)")

---

Tags

static analysispsalmpsalm-pluginbe-framework

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/be-framework-psalm-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/be-framework-psalm-plugin/health.svg)](https://phpackages.com/packages/be-framework-psalm-plugin)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[vimeo/psalm

A static analysis tool for finding errors in PHP applications

5.9k80.5M7.4k](/packages/vimeo-psalm)[maglnet/composer-require-checker

CLI tool to analyze composer dependencies and verify that no unknown symbols are used in the sources of a package

1.0k11.8M771](/packages/maglnet-composer-require-checker)[weirdan/doctrine-psalm-plugin

Stubs to let Psalm understand Doctrine better

897.2M58](/packages/weirdan-doctrine-psalm-plugin)[laraveldaily/filacheck

Static analysis for Filament projects - detect deprecated patterns and code issues

11755.4k](/packages/laraveldaily-filacheck)[php-code-archeology/php-code-archeology

Static analyzer for PHP project archeology. Calculates various metrics for your codebase.

772.8k](/packages/php-code-archeology-php-code-archeology)

PHPackages © 2026

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