xref: /dokuwiki/_test/phpcs.xml (revision ccc4c71ca88c25bcefb7f42eb01f0c040487e3a9)
1<?xml version="1.0"?>
2<ruleset name="DokuWiki Coding Standard Standard" namespace="DokuWiki\CS\Standard">
3    <description>Coding Standard used for DokuWiki</description>
4
5    <!-- default config -->
6    <arg name="colors"/>
7    <arg value="sp"/>
8    <arg name="extensions" value="php"/>
9
10    <ini name="memory_limit" value="-1" />
11
12    <!-- where to look -->
13    <file>../inc</file>
14    <file>../lib</file>
15    <file>../bin</file>
16    <file>../doku.php</file>
17    <file>../index.php</file>
18    <file>../feed.php</file>
19    <file>../install.php</file>
20
21    <!-- skip these completely -->
22    <exclude-pattern>*/lang/*/lang.php</exclude-pattern>
23    <exclude-pattern>*/lang/*/settings.php</exclude-pattern>
24    <exclude-pattern>*/_test/*</exclude-pattern>
25
26    <!-- 3rd party libs, these should be moved to composer some day -->
27    <exclude-pattern>*/inc/DifferenceEngine.php</exclude-pattern>
28    <exclude-pattern>*/inc/IXR_Library.php</exclude-pattern>
29    <exclude-pattern>*/inc/JSON.php</exclude-pattern>
30    <exclude-pattern>*/inc/JpegMeta.php</exclude-pattern>
31    <exclude-pattern>*/lib/plugins/authad/adLDAP</exclude-pattern>
32
33    <!-- rules on top of PSR-2 -->
34    <rule ref="PSR2">
35        <!-- the following rule is not in PSR-2 and breaks the guardian pattern -->
36        <exclude name="Generic.ControlStructures.InlineControlStructure.NotAllowed"/>
37
38        <!-- we have lots of legacy classes without name spaces -->
39        <exclude name="PSR1.Classes.ClassDeclaration.MissingNamespace"/>
40    </rule>
41
42    <!-- disable some rules for certain paths, for legacy support -->
43    <rule ref="Squiz.Classes.ValidClassName.NotCamelCaps">
44        <exclude-pattern>*/inc/parser/*</exclude-pattern>
45
46        <exclude-pattern>*/inc/Plugin.php</exclude-pattern>
47        <exclude-pattern>*/inc/PluginInterface.php</exclude-pattern>
48
49        <exclude-pattern>*/lib/plugins/*.php</exclude-pattern>
50        <exclude-pattern>*/lib/plugins/*/action.php</exclude-pattern>
51        <exclude-pattern>*/lib/plugins/*/action/*.php</exclude-pattern>
52        <exclude-pattern>*/lib/plugins/*/admin.php</exclude-pattern>
53        <exclude-pattern>*/lib/plugins/*/admin/*.php</exclude-pattern>
54        <exclude-pattern>*/lib/plugins/*/auth.php</exclude-pattern>
55        <exclude-pattern>*/lib/plugins/*/auth/*.php</exclude-pattern>
56        <exclude-pattern>*/lib/plugins/*/cli.php</exclude-pattern>
57        <exclude-pattern>*/lib/plugins/*/cli/*.php</exclude-pattern>
58        <exclude-pattern>*/lib/plugins/*/helper.php</exclude-pattern>
59        <exclude-pattern>*/lib/plugins/*/helper/*.php</exclude-pattern>
60        <exclude-pattern>*/lib/plugins/*/remote.php</exclude-pattern>
61        <exclude-pattern>*/lib/plugins/*/remote/*.php</exclude-pattern>
62        <exclude-pattern>*/lib/plugins/*/syntax.php</exclude-pattern>
63        <exclude-pattern>*/lib/plugins/*/syntax/*.php</exclude-pattern>
64    </rule>
65
66    <!-- underscore skips exposing public methods to remote api -->
67    <rule ref="PSR2.Methods.MethodDeclaration.Underscore">
68        <exclude-pattern>*/lib/plugins/remote.php</exclude-pattern>
69        <exclude-pattern>*/lib/plugins/*/remote.php</exclude-pattern>
70        <exclude-pattern>*/lib/plugins/*/remote/*.php</exclude-pattern>
71    </rule>
72
73    <rule ref="PSR1.Methods.CamelCapsMethodName.NotCamelCaps">
74        <exclude-pattern>*/inc/parser/*</exclude-pattern>
75    </rule>
76
77    <!-- for now we mix declarations and execution here FIXME -->
78    <rule ref="PSR1.Files.SideEffects">
79        <exclude-pattern>*/doku.php</exclude-pattern>
80        <exclude-pattern>*/install.php</exclude-pattern>
81        <exclude-pattern>*/feed.php</exclude-pattern>
82        <exclude-pattern>*/bin/*.php</exclude-pattern>
83        <exclude-pattern>*/lib/exe/*.php</exclude-pattern>
84    </rule>
85
86</ruleset>
87