symplify/easy-coding-standard

News 🎉

Add NoBlankLineBetweenImportsFixer to the spaces set

Removes blank lines between consecutive import use statements, while keeping the blank line after the namespace intact. Ported from a custom fixer used in the Mautic codebase.

 use App\First;
-
 use App\Second;

ecsphp/ecs-src#75

JSON output always reports absolute paths

JsonOutputFormatter now always reports absolute paths - the format machines consume (IDE links, CI ingestion) - so no toggle is needed.

ecsphp/ecs-src#70

Deprecated 💀

🧹 Fixer-first: deprecate the CI report formats

ECS is a fixer by default, not a static analyzer. The report formats that target CI static-analysis pipelines now emit a warning and fall back to console:

• junit — ecsphp/ecs-src#69
• gitlab — ecsphp/ecs-src#71
• checkstyle — ecsphp/ecs-src#74

Remaining formatters: console and json.

Deprecate withRealPathReporting()

Kept as a deprecation warning pointing to --output-format json, now that JSON output always reports absolute paths.

ecsphp/ecs-src#70

Deprecate withEditorConfig()

.editorconfig discovery silently leaked project-wide settings into ECS, overriding the rules configured through sets. Coding standard should be driven by the ECS config. withEditorConfig() is kept as a deprecation warning; configure the matching PHP-CS-Fixer rules explicitly instead.

ecsphp/ecs-src#68

Deprecate withPhpCsFixerSets()

Prepared sets cover the same ground with a simpler API. withPhpCsFixerSets() is reduced to a deprecation no-op pointing to ->withPreparedSets() / ->withSets().

ecsphp/ecs-src#66

Removed 🗑️

Remove the deprecated symplify set

The symplify set was already a no-op loading zero rules; its rules live in the common sets. The symplify arg of withPreparedSets() and SetList::SYMPLIFY are removed - switch to ->withPreparedSets(common: true) or the matching with*Level() methods.

ecsphp/ecs-src#67

Remove dead code

• Remove the deprecated phpunit and strict set stub files - ecsphp/ecs-src#72
• Remove the dead Option::ONLY constant - ecsphp/ecs-src#73

What's new

🐛 Fix fatal error when configuring a PHP-CS-Fixer fixer

ECS replaces symfony/console, so Symfony\Component\Console\Application is never installed. Configuring a php-cs-fixer fixer with a deprecated option ran ConfigurableFixerTrait::configure(), which calls PhpCsFixer\Console\Application::getMajorVersion() — a class that extends the missing Symfony Application, so PHP fatalled resolving the parent:

PHP Fatal error: Uncaught Error: Class "Symfony\Component\Console\Application" not found

Now a declaration-only stub ships in /stubs (prefixed by php-scoper in the release build), so the run proceeds instead of fatalling:

-<?php  $x=1;
+<?php
+
+$x = 1;

A Configured Fixer CI reproducer guards against regressions.

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.

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'
+)]

What's new

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

-/**
- * Contacts a user.
  *
  * @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.

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.

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
+)

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,
 ) {
 }

What's new

✨ New StandaloneLineRequiredParamFixer (spaces set)

Public methods marked #[Required] / @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