Feat: Add OctalNotationFixer for explicit octal notation using 0o in PHP 8.1+ (part of #94)

Author: OndraM

Diff for: ecs.php

@@ -46,6 +46,7 @@
 use PhpCsFixer\Fixer\AttributeNotation\AttributeEmptyParenthesesFixer;
 use PhpCsFixer\Fixer\Basic\BracesFixer;
 use PhpCsFixer\Fixer\Basic\NoTrailingCommaInSinglelineFixer;
+use PhpCsFixer\Fixer\Basic\OctalNotationFixer;
 use PhpCsFixer\Fixer\Basic\PsrAutoloadingFixer;
 use PhpCsFixer\Fixer\Basic\SingleLineEmptyBodyFixer;
 use PhpCsFixer\Fixer\Casing\ClassReferenceNameCasingFixer;
@@ -245,6 +246,8 @@
             SingleLineEmptyBodyFixer::class, // Defined in PER 2.0
             // Values separated by a comma on a single line should not have a trailing comma.
             NoTrailingCommaInSinglelineFixer::class,
+            // Literal octal must be in 0o notation.
+            OctalNotationFixer::class,
             // Arrays should be formatted like function/method arguments
             TrimArraySpacesFixer::class,
             // In array declaration, there MUST be a whitespace after each comma

Diff for: tests/Integration/CodingStandardTest.php

@@ -39,6 +39,20 @@ public function provideFilesToFix(): array
         ];
     }
 
+    /**
+     * @test
+     * @requires PHP >= 8.1
+     */
+    public function shouldFixPhp81(): void
+    {
+        $fixedFile = $this->runEcsCheckOnFile(__DIR__ . '/Fixtures/Php81.wrong.php.inc');
+
+        $this->assertStringEqualsFile(
+            __DIR__ . '/Fixtures/Php81.correct.php.inc',
+            file_get_contents($fixedFile),
+        );
+    }
+
     private function runEcsCheckOnFile(string $file): string
     {
         $fixtureFile = $this->initTempFixtureFile();

Diff for: tests/Integration/Fixtures/Php81.correct.php.inc

@@ -0,0 +1,12 @@
+<?php declare(strict_types=1);
+
+namespace Lmc\CodingStandard\Integration\Fixtures;
+
+class Php81
+{
+    public function php81features(): void
+    {
+        // OctalNotationFixer
+        $numberInOctalNotation = 0o123;
+    }
+}

Diff for: tests/Integration/Fixtures/Php81.wrong.php.inc

@@ -0,0 +1,12 @@
+<?php declare(strict_types=1);
+
+namespace Lmc\CodingStandard\Integration\Fixtures;
+
+class Php81
+{
+    public function php81features(): void
+    {
+        // OctalNotationFixer
+        $numberInOctalNotation = 0123;
+    }
+}