single_import_per_statement.rst

Rule single_import_per_statement

There MUST be one use keyword per declaration.

Configuration

group_to_single_imports

Whether to change group imports into single imports.

Allowed types: bool

Default value: true

Examples

Example #1

Default configuration.

--- Original
+++ New
 <?php
-use Foo, Sample, Sample\Sample as Sample2;
+use Foo;
+use Sample;
+use Sample\Sample as Sample2;

Example #2

With configuration: ['group_to_single_imports' => true].

--- Original
+++ New
 <?php
-use Space\Models\ {
-    TestModelA,
-    TestModelB,
-    TestModel,
-};
+use Space\Models\TestModelA;
+use Space\Models\TestModelB;
+use Space\Models\TestModel;

Rule sets

The rule is part of the following rule sets:

• @PER with config:

  ['group_to_single_imports' => false]

• @PER-CS with config:

  ['group_to_single_imports' => false]

• @PER-CS1.0 with config:

  ['group_to_single_imports' => false]

• @PER-CS2.0 with config:

  ['group_to_single_imports' => false]

• @PSR2

• @PSR12 with config:

  ['group_to_single_imports' => false]

• @PhpCsFixer

• @Symfony

References

• Fixer class: PhpCsFixer\Fixer\Import\SingleImportPerStatementFixer
• Test class: PhpCsFixer\Tests\Fixer\Import\SingleImportPerStatementFixerTest

The test class defines officially supported behaviour. Each test case is a part of our backward compatibility promise.