Weave Code
Code Weaver
Helps Laravel developers discover, compare, and choose open-source packages. See popularity, security, maintainers, and scores at a glance to make better decisions.
Feedback
Share your thoughts, report bugs, or suggest improvements.
Subject
Message
Log in Register
Home
Packages
Easy Coding Standard
Release Notes

Easy Coding Standard Laravel Package

symplify/easy-coding-standard

Easy Coding Standard (ECS) makes PHP coding standards effortless on PHP 7.2–8.5. Fast parallel runs, supports PHP_CodeSniffer and PHP-CS-Fixer, uses prepared rule sets, generates ecs.php config on first run, and can check and auto-fix code with --fix.

View on GitHub
Deep Wiki
Context7
13.2.15

What's new

🐛 Explicit Symfony attribute allowlist in StandaloneLineSymfonyAttributeParamFixer

Replaces the str_contains($name, 'Symfony') heuristic with an explicit allowlist of 17 Symfony attribute classes (SYMFONY_ATTRIBUTE_CLASSES). Third-party attributes whose FQCN merely contains Symfony (e.g. App\Symfony\...) are no longer reformatted.

-#[\Symfony\Component\Console\Attribute\AsCommand(name: 'app:some', description: 'Some description')]
+#[\Symfony\Component\Console\Attribute\AsCommand(
+    name: 'app:some',
+    description: 'Some description'
+)]

🧹 Drop pull_request trigger from version_command workflow

The job smoke-tests the published Packagist artifact, so on PRs it installed the already-published package, never the PR code — pure slow noise. push (main + tags) and weekly schedule already cover it.

13.2.14

What's new

✨ New StandaloneLineSymfonyAttributeParamFixer + standaloneLine set

Breaks each argument of a Symfony attribute onto its own line. New opt-in standaloneLine set groups the standalone-line rules.

-#[\Symfony\Component\Console\Attribute\AsCommand(name: 'mautic:entity:import', description: 'Import entity data from a ZIP file.')]
+#[\Symfony\Component\Console\Attribute\AsCommand(
+    name: 'mautic:entity:import',
+    description: 'Import entity data from a ZIP file.'
+)]

$ecsConfig->withPreparedSets(standaloneLine: true);
// or
$ecsConfig->withSets([SetList::STANDALONE_LINE]);

🐛 Recognize imported short-name Symfony attributes

Now resolves short names against use imports, not just fully-qualified names.

 use Symfony\Component\Console\Attribute\AsCommand;

-#[AsCommand(name: 'app:some', description: 'Some description')]
+#[AsCommand(
+    name: 'app:some',
+    description: 'Some description'
+)]
13.2.13

What's new

🐛 Drop 3rd-person verb s in method-name duplicate description

-/**
- * Contacts a user.
  *
  * [@return](https://github.com/return) object
  */
 public function contactUser()

🐛 Fix scoper.php for FinalInternalClassFixer (#24)

Prefixed build no longer mangles the exclude entity names:

-'exclude' => ['final', 'Entity', 'ECSPrefix202607\ORM\Entity', ...]
+'exclude' => ['final', 'Entity', 'ORM\Entity', ...]

✅ Regression fixture: readonly promoted properties

Locks StandaloneLinePromotedPropertyFixer splitting private readonly promoted props.

13.2.12

What's new

🐛 StandaloneLinePlainConstructorParamFixer skips ≤3 params

Only splits constructors with 4+ params. Short lists stay on one line. Default-value tokens ([1, 2], new Foo(1)) don't inflate the count.

13.2.11

What's new

✨ New StandaloneLinePlainConstructorParamFixer (spaces set)

Covers the gap: constructors with plain params and no promoted properties.

-public function __construct(CorePermissions $security, Translator $translator, RouterInterface $router, FormFactoryInterface $formFactory)
+public function __construct(
+    CorePermissions $security,
+    Translator $translator,
+    RouterInterface $router,
+    FormFactoryInterface $formFactory
+)
13.2.10

What's new

✅ Regression fixture: single promoted property among plain params

Locks StandaloneLinePromotedPropertyFixer splitting all params even when only one is promoted.

 public function __construct(
-    CorePermissions $security, Translator $translator, RouterInterface $router,
+    CorePermissions $security,
+    Translator $translator,
+    RouterInterface $router,
     private LeadModel $leadModel,
 ) {
 }
13.2.9

What's new

✨ New StandaloneLineRequiredParamFixer (spaces set)

Public methods marked #[Required] / [@required](https://github.com/required) are DI points; one param per line keeps diffs to the single changed dependency.

 #[Required]
-public function autowireDependencies(FormModel $formModel, SubmissionModel $submissionModel): void
+public function autowireDependencies(
+    FormModel $formModel,
+    SubmissionModel $submissionModel
+): void
13.2.8

What's new

🐛 Fix autoloading of nested paths

🐛 Match method-name docblock descriptions containing articles

-/**
- * Get the API helper.
- *
+/**
  * [@return](https://github.com/return) object
  */
 public function getApiHelper()

Drops a/an/the (word-boundary) before comparing description to method name.

📖 Document passing paths as CLI arguments in README

vendor/bin/ecs src tests
13.2.7

What's new

🐛 Fix --config option placed before the command name

# before
$ ecs --config=ecs.php
Run failed: Unknown option: "--config=ecs.php"

# after
$ ecs --config=ecs.php   # loads ecs.php and checks normally

Regression from the symfony/console → entropy migration. Default check command is now injected when the first arg is an option.

🐛 Skip AddMissingVarNameFixer for property assignments

-/** [@var](https://github.com/var) int $this */
+/** [@var](https://github.com/var) int */
 $this->value = 1000;

Skipped when the variable is followed by ->.

13.2.6

What's new

✨ New TypeToVarTagFixer

Flips [@type](https://github.com/type) doc tag into [@var](https://github.com/var), upgrading single-asterisk inline comments to real doc blocks.

-/* [@type](https://github.com/type) \Mautic\ReportBundle\Model\ReportModel $model */
+/** [@var](https://github.com/var) \Mautic\ReportBundle\Model\ReportModel $model */
 $model = ...;

✨ New MergeDocBlockStartFixer

Fixes docblocks opened with /* instead of /** and strips empty *-only lines.

-/*
- *
- * [@return](https://github.com/return) $this
- */
+/**
+ * [@return](https://github.com/return) $this
+ */

✨ New RemoveEventSubscriberDescriptionFixer

Removes redundant subscriber-method docblocks that just repeat the method name + "event".

-/**
- * Delete lead event
- */
 public function onLeadDelete(LeadEvent $event): bool

🐛 Remove getter/setter verb-mismatch docblock description

RemoveMethodNameDuplicateDescriptionFixer now drops * Get results. above setResults() (get/set mix-up carries no info).

✅ Cover RemoveDeadParamFixer for anonymous functions

-/**
- * [@param](https://github.com/param) $mappedFields
- * [@param](https://github.com/param) $fieldType
- */
 $cleanup = function (array &$mappedFields, string $fieldType) {
 };

🐛 Fix PHPStan env-dependent token constant error

Scope PHPStan ignores for T_OPEN_CURLY_BRACKET (PHP_CodeSniffer constant) across environments.

13.2.5

What's new

🐛 Fix preload

Preload path fix after the console / dependency migration.

13.2.4

What's new

🚀 42 new rules across common sets + Levels

Two new sets (casing, cleanup) and 40 more mature, non-PSR-12 rules wired into the gradual-adoption Levels.

-STRLEN($name);                  // NativeFunctionCasing
+strlen($name);
-$a = [ ];                       // NoWhitespaceInEmptyArray
+$a = [];
-/** [@return](https://github.com/return) integer */          // PhpdocScalar
+/** [@return](https://github.com/return) int */
-$x = isset($a) ? $a : $b;       // TernaryToNullCoalescing
+$x = $a ?? $b;

New [@api](https://github.com/api) consts SetList::CASING, SetList::CLEANUP; withPreparedSets(casing:, cleanup:).

⚠️ Deprecate symplify set, remove phpunit + strict sets

symplify soft-deprecated (rules now in common under clearer names). phpunit and strict removed — dangerous without context, use Rector instead.

 return ECSConfig::configure()
     ->withPreparedSets(
         common: true,
-        symplify: true,
-        phpunit: true,
-        strict: true,
     );

✨ New FixTagTypoFixer

Fixes plural doc-block tag typos ([@returns](https://github.com/returns)→[@return](https://github.com/return), [@params](https://github.com/params)→[@param](https://github.com/param), [@vars](https://github.com/vars)→[@var](https://github.com/var)), incl. psalm-/phpstan- prefixes.

🐛 Fix AddMissingVarNameFixer for intersection types

-/** [@var](https://github.com/var) MockObject&AbstractIntegration */
+/** [@var](https://github.com/var) MockObject&AbstractIntegration $integration */
 $integration = $this->getMockBuilder(AbstractIntegration::class);

🐛 Fix SwitchedTypeAndNameFixer for generics with commas

-[@param](https://github.com/param) $submittedArray array<int, string>
+[@param](https://github.com/param) array<int, string> $submittedArray

🐛 Skip [@param](https://github.com/param) comment text mistaken as switched type

[@param](https://github.com/param) $extra Can be used by ... no longer reordered — trailing words are a description, not a type.

🐛 Remove method-name duplicate description with trailing punctuation

RemoveMethodNameDuplicateDescriptionFixer now strips * Set name. (trailing ./!) above setName().

🧹 Internals

  • Drop symfony/console, migrate console layer to entropy/entropy (#27)
  • Inline symplify/easy-parallel for fewer deps (#28)
  • Resolve PHPStan errors (#29)
13.2.3

What's new

⚠️ Deprecate old symfony-legacy closure configuration

The legacy closure-based Symfony config is deprecated. Use the fluent API instead:

return ECSConfig::configure()
    ->withPreparedSets(common: true);
13.2.2

What's new

✨ New RemoveDeadVarThisFixer

Removes pointless [@var](https://github.com/var) $this docblocks above $this calls — they add noise and never help type inference. Added to the docblock level.

 function someFunction()
 {
-    /** [@var](https://github.com/var) SomeType $this */
     $this->run();
 }

🐛 Fix AddMissingVarNameFixer for array item types

The fixer now correctly appends the variable name when the [@var](https://github.com/var) type is an array shape like int[]:

 function arrayItems()
 {
-    /** [@var](https://github.com/var) int[] */
+    /** [@var](https://github.com/var) int[] $values */
     $values = [1000];
 }
13.2.0

The headline of this release: ECS is now a single package. The symplify/coding-standard fixers moved in-tree, and the Laravel container dependency is gone. No breaking changes for users — the Symplify\CodingStandard\Fixer\* class names are unchanged.

⬆️ How to upgrade

If you previously required symplify/coding-standard directly, drop it — it now ships inside ECS:

composer remove symplify/coding-standard --dev
composer require symplify/easy-coding-standard:^13.2 --dev

Your ecs.php needs no changes: the Symplify\CodingStandard\Fixer\* class names are unchanged. If you only ever required symplify/easy-coding-standard, a plain composer update symplify/easy-coding-standard is all you need.

🎯 Highlights

1. symplify/coding-standard merged into ECS (#19)

The 26 custom Symplify fixers ECS has always relied on now live directly in this repository under packages/coding-standard/. ECS could never run without them, and many prepared sets are tightly coupled to them — so maintaining two repos added friction for no benefit.

What this means for you:

  • One package instead of two. composer require symplify/easy-coding-standard --dev no longer pulls in a separate symplify/coding-standard.

  • Class names are unchanged — your existing ecs.php keeps working as-is:

    // ecs.php — still valid, no change needed
use Symplify\EasyCodingStandard\Config\ECSConfig;
use Symplify\CodingStandard\Fixer\LineLength\LineLengthFixer;

return ECSConfig::configure()
    ->withRules([LineLengthFixer::class]);
    ->withPreparedSets(symplify: true);

2. withDocblockLevel() now goes much deeper (#19)

Because the Symplify commenting fixers now ship in-tree, the gradual docblock level gained 11 new rules (24 total). You opt in one level per PR, safest first:

// ecs.php
use Symplify\EasyCodingStandard\Config\ECSConfig;

return ECSConfig::configure()
    ->withDocblockLevel(5); // ramp up one level at a time

New rules now reachable through the level include inline [@var](https://github.com/var) normalization (DoubleAsteriskInlineVarFixer, SingleLineInlineVarDocBlockFixer, AddMissingVarNameFixer), [@param](https://github.com/param) fixes (AddMissingParamNameFixer, FixParamNameTypoFixer, RemoveParamNameReferenceFixer, RemoveDeadParamFixer), and superfluous-name removal (RemoveSuperfluousReturnNameFixer, RemoveSuperfluousVarNameFixer).

3. illuminate/container replaced with entropy/entropy (#17)

ECS's DI container no longer extends Illuminate's. ECSConfig now extends Entropy\Container\Container.

What this means for you:

  • One less dependency in your install tree — illuminate/container and its bundled patch (patches/illuminate-container-container-php.patch) are gone.
  • Checker registration order and the documented duplicate-in-set behavior are preserved.
  • symfony/console stays — it's still a transitive dependency of PHP-CS-Fixer and easy-parallel, so it can't be dropped.

This is an internal change. If you only use the public ECSConfig::configure()->with...() API, nothing changes for you.

13.0.0

What's Changed

New Contributors

Full Changelog: https://github.com/easy-coding-standard/easy-coding-standard/compare/12.6.2...13.0.0

12.6.2

What's Changed

Full Changelog: https://github.com/easy-coding-standard/easy-coding-standard/compare/12.6.1...12.6.2

12.6.0

What's Changed

Full Changelog: https://github.com/easy-coding-standard/easy-coding-standard/compare/12.5.24...12.6.0

12.5.24
12.5.23

What's Changed

Full Changelog: https://github.com/easy-coding-standard/easy-coding-standard/compare/12.5.21...12.5.23

12.5.20

What's Changed

New Contributors

Full Changelog: https://github.com/easy-coding-standard/easy-coding-standard/compare/12.5.18...12.5.20

12.5.8

What's Changed

Full Changelog: https://github.com/easy-coding-standard/easy-coding-standard/compare/12.5.6...12.5.8

12.5.5

What's Changed

Full Changelog: https://github.com/easy-coding-standard/easy-coding-standard/compare/12.5.4...12.5.5

12.2.1

What's Changed

New Contributors

Full Changelog: https://github.com/easy-coding-standard/easy-coding-standard/compare/12.2.0...12.2.1

12.2.0

New Features :partying_face:

  • Add print PHP_CodeSniffer and PHP-CS-Fixer versions when --version (#201), thanks @zonuexe
  • Add new output formatter for checkstyle (#204), thanks @M-arcus
  • Bump to Rector 1.0
  • Bump php-cs-fixer and ecs to latest version
  • Implement --no-diffs CLI Option (#195), thanks @staabm

Bugfixes :bug:

  • [Configuration] Fix parallel config always replaced by next config as default to true
  • [Configuration] Do not sets, skip, rules on empty array on ECSConfigBuilder
  • Dynamic sets should be configured after sets (#188), thanks @zghosts
  • Less memory hungry FnMatchPathNormalizer: reduced by ~35-45% (#192), thanks @staabm
  • [Skipper] Allow skip relative path on command line vendor/bin/ecs check path/to/relative/path
  • Remove repeated calls to EasyCodingStandardStyle->isDebug() (#194), thanks @staabm
10.2.4

Make use of native ECSConfig in ecs.php

Running ECS on Symfony project can create conflict with native ContainerConfigurator. To avoid that, we introduce a new config, that is fully scoped and isolated within ECS.

Another big advantage is new configuration methods with validation and autocomplete right in your ide :+1:

Read more in https://tomasvotruba.com/blog/new-in-ecs-simpler-config/

Before :skull:

use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\EasyCodingStandard\ValueObject\Option;

// ups, possible conflict with ContainerConfigurator
return static function (ContainerConfigurator $containerConfigurator): void {
    $parameters = $containerConfigurator->parameters();

    // too verbose params, constants and possible typo in param value
    $parameters->set(Option::PATHS, [[ // ups, "[[" typo
        __DIR__ . '/src/',
    ]]);

    $services = $containerConfigurator->services();
    $services->set(ArraySyntaxFixer::class);
};

Now :tada:

use Symplify\EasyCodingStandard\Config\ECSConfig;
use Symplify\EasyCodingStandard\ValueObject\Set\SetList;

return static function (ECSConfig $ecsConfig): void {
    $ecsConfig->paths([
        __DIR__ . '/src',
    ]);

    $ecsConfig->rule(ArraySyntaxFixer::class);

    $ecsConfig->sets([SetList::PSR_12]);
};
9.4.67

ECS gets 100 % faster per 1 CPU thread :rocket:

Do you have multi-core CPUs? ECS can run in X parallel threads, where X is number of your threads. E.g. with laptop with AMD Ryzen 4750U it is 16.

That means 1600 % faster run with same amount of analysed files. Did you code base took 16 minutes to fix? Now it's 1 minute.

This feature is:

Do you Want to Safe Time? :timer_clock:

Try it:

// ecs.php
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symplify\EasyCodingStandard\ValueObject\Option;

return static function (ContainerConfigurator $containerConfigurator): void {
    $parameters = $containerConfigurator->parameters();

    $parameters->set(Option::PARALLEL, true);
};

And that's it :wink:

Aknowledgements

The parallel run is heavily based on @phpstan parallel run - thanks to Ondřej Mirtes for inspiration :pray:

v9.3.3

Dowgraded and Scoped version by Default

Since 9.3.3, the package is downgraded to PHP 7.1 and scoped. The former package https://github.com/symplify/easy-coding-standard-prefixed is deprecated and replaced by symplify/easy-coding-standard should be used instead.

Read more in standalone post https://tomasvotruba.com/blog/introducing-ecs-prefixed-and-downgraded-to-php-71

Weaver

How can I help you explore Laravel packages today?

Conversation history is not saved when not logged in.
Prompt
Add packages to context
No packages found.
calmfox/watch-sylius
damienfern/grpc-symfony-bundle
atoolo/index-bundle
atoolo/genai-bundle
coprotoai/laravel-ticket
davidjln/llm-carbon-bundle
cryonighter/valid-request-bundle
coolms/taxonomy-bundle
coolms/field-bundle
articulate-orm/symfony
aaix/laravel-tall-architect
ephoto/akeneo-connector
emmanuelballery/eb-plantumlbundle
emielburgman/symfony-visitor-beacon
emielburgman/symfony-visit-storage
emielburgman/symfony-security-headers
emielburgman/symfony-log-viewer
emarref/xdebug-bundle
emarref/pubnub-bundle
elriseio/finance-money-bundle