core/phpcs.xml at master · phalcon-kit/core · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
<?xml version="1.0"?>
<ruleset name="Phalcon Kit">
    <description>
        Phalcon Kit Coding Standards — PSR-12 foundation with pragmatic whitespace,
        modern PHP 8.4 syntax support, and framework-friendly flexibility.
    </description>

    <!-- ====================================================== -->
    <!-- Global CLI behaviour -->
    <!-- ====================================================== -->

    <!-- Pretty output and parallel scanning -->
    <arg name="colors"/>
    <arg name="parallel" value="16"/>
    <arg value="p"/> <!-- show progress -->
    <arg value="s"/> <!-- show sniff codes -->
    <arg value="w"/> <!-- show warnings -->

    <!-- Define base path for relative includes -->
    <config name="basepath" value="."/>

    <!-- Target PHP version (8.4.x) -->
    <config name="php_version" value="80400"/>

    <!-- ====================================================== -->
    <!-- Base Standard with targeted relaxations -->
    <!-- ====================================================== -->

    <rule ref="PSR12">
        <!-- ==== Relax control-structure formatting ==== -->
        <exclude name="PSR2.ControlStructures.ElseIfDeclaration.NotAllowed"/>
        <exclude name="Squiz.ControlStructures.ElseIfDeclaration.NotAllowed"/>
        <exclude name="PSR12.ControlStructures.ControlStructureSpacing"/>
        <exclude name="Squiz.ControlStructures.ControlSignature"/>
        <exclude name="Squiz.ControlStructures.ControlSignature.SpaceAfterCloseBrace"/>
        <exclude name="Squiz.WhiteSpace.ScopeClosingBrace"/>

        <!-- ==== Allow indented blank lines ==== -->
        <exclude name="Squiz.WhiteSpace.SuperfluousWhitespace.EndLine"/>
        <exclude name="Squiz.WhiteSpace.SuperfluousWhitespace.EmptyLines"/>
        <exclude name="Squiz.WhiteSpace.SuperfluousWhitespace"/>

        <!-- ==== Allow longer lines and underscores ==== -->
        <exclude name="Generic.Files.LineLength"/>
        <exclude name="PSR2.Methods.MethodDeclaration.Underscore"/>
        <exclude name="PSR2.Classes.PropertyDeclaration.Underscore"/>
    </rule>

    <rule ref="PSR12.Files.FileHeader">
        <exclude name="PSR12.Files.FileHeader.IncorrectOrder"/>
    </rule>

    <!-- ====================================================== -->
    <!-- Optional style refinements -->
    <!-- ====================================================== -->

    <!-- Ignore line-length limit for comments and docblocks -->
    <rule ref="Generic.Files.LineLength">
        <properties>
            <property name="ignoreComments" value="true"/>
            <property name="absoluteLineLimit" value="0"/>
        </properties>
    </rule>

    <!-- Disallow long array syntax (prefer []) -->
    <rule ref="Generic.Arrays.DisallowLongArraySyntax"/>

    <!-- Prevent multiple statements per line -->
    <rule ref="Generic.Formatting.DisallowMultipleStatements"/>

    <!-- ====================================================== -->
    <!-- Project-specific files and exclusions -->
    <!-- ====================================================== -->

    <!-- Folders to scan -->
    <file>src</file>
    <file>tests</file>

    <!-- Ignore vendor & generated content -->
    <exclude-pattern>vendor/*</exclude-pattern>
    <exclude-pattern>resources/*</exclude-pattern>
    <exclude-pattern>public/*</exclude-pattern>
    <exclude-pattern>storage/*</exclude-pattern>
    <exclude-pattern>var/*</exclude-pattern>
    <exclude-pattern>node_modules/*</exclude-pattern>

</ruleset>