Generic/EmptyPHPStatement: add documentation

rodrigoprimo · Dec 14, 2023 · 60eeaca · 60eeaca
1 parent 88d3cec
commit 60eeaca
Showing 1 changed file with 44 additions and 0 deletions.
diff --git a/src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml b/src/Standards/Generic/Docs/CodeAnalysis/EmptyPHPStatementStandard.xml
@@ -0,0 +1,44 @@
+<documentation title="Empty PHP Statement">
+    <standard>
+    <![CDATA[
+    Empty PHP tags are not allowed.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: There is at least one statement inside the PHP tag pair.">
+        <![CDATA[
+<?php echo 'Hello World'; ?>
+<?= 'Hello World'; ?>
+        ]]>
+        </code>
+        <code title="Invalid: There is no statement inside the PHP tag pair.">
+        <![CDATA[
+<?php // some comment ?>
+<?= ?>
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Superfluous semi-colons are not allowed.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: There is no superfluous semi-colon after a PHP statement.">
+            <![CDATA[
+function_call();
+if (true) {
+    echo 'Hello World';
+}
+        ]]>
+        </code>
+        <code title="Invalid: There are one or more superfluous semi-colons after a PHP statement.">
+            <![CDATA[
+function_call();;;
+if (true) {
+    echo 'Hello World';
+};
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>