symplify/phpstan-extensions

Pre-escaped error messages in 'symplify' error format, container aware test case and other useful extensions for PHPStan

Installs: 4 395 057

Dependents: 78

Suggesters: 0

Security: 0

Stars: 34

Watchers: 3

Forks: 5

Open Issues: 1

Type:phpstan-extension

12.0.1 2025-01-07 09:31 UTC

This package is auto-updated.

Last update: 2025-01-07 09:31:42 UTC


README

Downloads total


Install

composer require symplify/phpstan-extensions --dev

Symplify Error Formatter

Update your phpstan.neon config:

parameters:
    errorFormat: symplify
  • Do you want to click the error and get right to the line in the file it's reported at?
  • Do you want to copy-paste regex escaped error to your ignoreErrors?

Works best with anthraxx/intellij-awesome-console

vendor/bin/phpstan analyse src

------------------------------------------------------------------------------------------
src/Command/ReleaseCommand.php:51
------------------------------------------------------------------------------------------
- "Call to an undefined method Symplify\\Command\\ReleaseCommand\:\:nonExistingCall\(\)"
------------------------------------------------------------------------------------------

Improved Symfony Types

ContainerGetTypeExtension

With Symfony container and type as an argument, you always know the same type is returned:

use Symfony\Component\DependencyInjection\Container;

/** @var Container $container */
// PHPStan: object ❌
$container->get(Type::class);
// Reality: Type ✅
$container->get(Type::class);

// same for in-controller/container-aware context
$this->get(Type::class);

KernelGetContainerAfterBootReturnTypeExtension

After Symfony Kernel boot, getContainer() always returns the container:

use Symfony\Component\HttpKernel\Kernel;

final class AppKernel extends Kernel
{
    // ...
}

$kernel = new AppKernel('prod', false);
$kernel->boot();

// PHPStan: null|ContainerInterface ❌
$kernel->getContainer();
// Reality: ContainerInterface ✅
$kernel->getContainer();
// Reality: ContainerInterface ✅

SplFileInfoTolerantReturnTypeExtension

Symfony Finder finds only existing files (obviously), so the getRealPath() always return string:

use Symfony\Component\Finder\Finder;

$finder = new Finder();

foreach ($finder as $fileInfo) {
    // PHPStan: false|string ❌
    $fileInfo->getRealPath();
    // Reality: string ✅
    $fileInfo->getRealPath();
}

Happy coding!