.phpcs.xml

   1 <?xml version="1.0"?>
   2 <ruleset name="MediaWiki">
   3         <rule ref="./vendor/mediawiki/mediawiki-codesniffer/MediaWiki">
   4                 <exclude name="Generic.ControlStructures.InlineControlStructure" />
   5                 <exclude name="MediaWiki.Commenting.FunctionComment.MissingDocumentationProtected" />
   6                 <exclude name="MediaWiki.Commenting.FunctionComment.MissingDocumentationPublic" />
   7                 <exclude name="MediaWiki.Commenting.FunctionComment.MissingParamTag" />
   8                 <exclude name="MediaWiki.Commenting.FunctionComment.MissingReturn" />
   9                 <exclude name="MediaWiki.Commenting.FunctionComment.ExtraParamComment" />
  10                 <exclude name="MediaWiki.Commenting.FunctionComment.WrongStyle" />
  11                 <exclude name="MediaWiki.Commenting.IllegalSingleLineComment.IllegalSingleLineCommentStart" />
  12                 <exclude name="MediaWiki.Commenting.IllegalSingleLineComment.IllegalSingleLineCommentEnd" />
  13                 <exclude name="MediaWiki.ControlStructures.AssignmentInControlStructures.AssignmentInControlStructures" />
  14                 <exclude name="MediaWiki.NamingConventions.LowerCamelFunctionsName.FunctionName" />
  15                 <exclude name="MediaWiki.Usage.DbrQueryUsage.DbrQueryFound" />
  16                 <exclude name="MediaWiki.Usage.DeprecatedGlobalVariables.Deprecated$wgContLang" />
  17                 <exclude name="MediaWiki.Usage.DeprecatedGlobalVariables.Deprecated$wgTitle" />
  18                 <exclude name="MediaWiki.Usage.ForbiddenFunctions.passthru" />
  19                 <exclude name="MediaWiki.WhiteSpace.SpaceBeforeSingleLineComment.NewLineComment" />
  20                 <exclude name="MediaWiki.WhiteSpace.SpaceBeforeSingleLineComment.SingleSpaceBeforeSingleLineComment" />
  21                 <exclude name="Squiz.Scope.MethodScope.Missing" />
  22         </rule>
  23         <rule ref="MediaWiki.NamingConventions.PrefixedGlobalFunctions">
  24                 <properties>
  25                         <!--
  26                         includes/GlobalFunctions.php
  27                         * mimeTypeMatch
  28                         maintenance/cdb.php
  29                         * cdbShowHelp
  30                         maintenance/language/transstat.php
  31                         * showUsage
  32                         maintenance/mcc.php
  33                         * mccGetHelp
  34                         * mccShowUsage
  35                         maintenance/storage/moveToExternal.php
  36                         * moveToExternal
  37                         maintenance/storage/resolveStubs.php
  38                         * resolveStub
  39                         * resolveStubs
  40                         profileinfo.php
  41                         * compare_point
  42                         * getEscapedProfileUrl
  43                         tests/phpunit/includes/HooksTest.php
  44                         * NothingFunction
  45                         * NothingFunctionData
  46                         tests/qunit/data/styleTest.css.php
  47                         * cssfilter
  48                         -->
  49                         <property name="ignoreList" type="array" value="cdbShowHelp,compare_point,cssfilter,getEscapedProfileUrl,mccGetHelp,mccShowUsage,mimeTypeMatch,moveToExternal,NothingFunction,NothingFunctionData,resolveStub,resolveStubs,showUsage" />
  50                 </properties>
  51         </rule>
  52         <rule ref="MediaWiki.NamingConventions.ValidGlobalName">
  53                 <properties>
  54                         <property name="ignoreList" type="array" value="$IP,$messageMemc" />
  55                 </properties>
  56         </rule>
  57         <rule ref="MediaWiki.NamingConventions.ValidGlobalName.allowedPrefix">
  58                 <exclude-pattern>profileinfo\.php</exclude-pattern>
  59                 <exclude-pattern>maintenance/language/checkLanguage\.inc</exclude-pattern>
  60                 <exclude-pattern>maintenance/doMaintenance\.php</exclude-pattern>
  61                 <exclude-pattern>maintenance/mergeMessageFileList\.php</exclude-pattern>
  62                 <exclude-pattern>maintenance/commandLine\.inc</exclude-pattern>
  63                 <exclude-pattern>tests/phpunit/MediaWikiIntegrationTestCase\.php</exclude-pattern>
  64         </rule>
  65         <rule ref="Generic.Files.LineLength">
  66                 <exclude-pattern>*/languages/messages/Messages*\.php</exclude-pattern>
  67         </rule>
  68         <rule ref="MediaWiki.Files.ClassMatchesFilename.NotMatch">
  69                 <!--
  70                         Whitelist existing violations, but enable the sniff to prevent
  71                         any new occurrences.
  72                 -->
  73                 <exclude-pattern>*/includes/specials/SpecialMostimages\.php</exclude-pattern>
  74                 <exclude-pattern>*/includes/specials/SpecialMovepage\.php</exclude-pattern>
  75                 <exclude-pattern>*/includes/specials/SpecialRandompage\.php</exclude-pattern>
  76                 <exclude-pattern>*/includes/specials/SpecialUserrights\.php</exclude-pattern>
  77                 <exclude-pattern>*/includes/specials/SpecialWantedfiles\.php</exclude-pattern>
  78                 <exclude-pattern>*/includes/specials/SpecialWantedpages\.php</exclude-pattern>
  79                 <exclude-pattern>*/maintenance/CodeCleanerGlobalsPass.inc</exclude-pattern>
  80                 <exclude-pattern>*/maintenance/archives/upgradeLogging\.php</exclude-pattern>
  81                 <exclude-pattern>*/maintenance/benchmarks/bench_HTTP_HTTPS\.php</exclude-pattern>
  82                 <exclude-pattern>*/maintenance/benchmarks/bench_Wikimedia_base_convert\.php</exclude-pattern>
  83                 <exclude-pattern>*/maintenance/benchmarks/bench_delete_truncate\.php</exclude-pattern>
  84                 <exclude-pattern>*/maintenance/benchmarks/bench_if_switch\.php</exclude-pattern>
  85                 <exclude-pattern>*/maintenance/benchmarks/bench_utf8_title_check\.php</exclude-pattern>
  86                 <exclude-pattern>*/maintenance/benchmarks/bench_wfIsWindows\.php</exclude-pattern>
  87                 <exclude-pattern>*/maintenance/cleanupTable.inc</exclude-pattern>
  88                 <exclude-pattern>*/maintenance/cleanupTitles\.php</exclude-pattern>
  89                 <exclude-pattern>*/maintenance/commandLine.inc</exclude-pattern>
  90                 <exclude-pattern>*/maintenance/edit\.php</exclude-pattern>
  91                 <exclude-pattern>*/maintenance/findDeprecated\.php</exclude-pattern>
  92                 <exclude-pattern>*/maintenance/getText\.php</exclude-pattern>
  93                 <exclude-pattern>*/maintenance/hhvm/makeRepo\.php</exclude-pattern>
  94                 <exclude-pattern>*/maintenance/importDump\.php</exclude-pattern>
  95                 <exclude-pattern>*/maintenance/install\.php</exclude-pattern>
  96                 <exclude-pattern>*/maintenance/invalidateUserSessions\.php</exclude-pattern>
  97                 <exclude-pattern>*/maintenance/jsparse\.php</exclude-pattern>
  98                 <exclude-pattern>*/maintenance/lag\.php</exclude-pattern>
  99                 <exclude-pattern>*/maintenance/language/StatOutputs\.php</exclude-pattern>
 100                 <exclude-pattern>*/maintenance/language/checkLanguage.inc</exclude-pattern>
 101                 <exclude-pattern>*/maintenance/language/date-formats\.php</exclude-pattern>
 102                 <exclude-pattern>*/maintenance/language/languages.inc</exclude-pattern>
 103                 <exclude-pattern>*/maintenance/minify\.php</exclude-pattern>
 104                 <exclude-pattern>*/maintenance/mysql\.php</exclude-pattern>
 105                 <exclude-pattern>*/maintenance/parse\.php</exclude-pattern>
 106                 <exclude-pattern>*/maintenance/preprocessorFuzzTest\.php</exclude-pattern>
 107                 <exclude-pattern>*/maintenance/rebuildImages\.php</exclude-pattern>
 108                 <exclude-pattern>*/maintenance/renderDump\.php</exclude-pattern>
 109                 <exclude-pattern>*/maintenance/shell\.php</exclude-pattern>
 110                 <exclude-pattern>*/maintenance/sql\.php</exclude-pattern>
 111                 <exclude-pattern>*/maintenance/sqlite.inc</exclude-pattern>
 112                 <exclude-pattern>*/maintenance/sqlite\.php</exclude-pattern>
 113                 <exclude-pattern>*/maintenance/term/MWTerm\.php</exclude-pattern>
 114                 <exclude-pattern>*/maintenance/update\.php</exclude-pattern>
 115                 <exclude-pattern>*/maintenance/userDupes.inc</exclude-pattern>
 116                 <exclude-pattern>*/maintenance/userOptions\.php</exclude-pattern>
 117                 <exclude-pattern>*/maintenance/view\.php</exclude-pattern>
 118                 <exclude-pattern>*/profileinfo\.php</exclude-pattern>
 119                 <!-- Language converters use the pattern of 2 classes in one file -->
 120                 <exclude-pattern>*/languages/*\.php</exclude-pattern>
 121                 <!-- Skip violations in some tests for now -->
 122                 <exclude-pattern>*/tests/parser/*\.php</exclude-pattern>
 123                 <exclude-pattern>*/tests/phan/*\.php</exclude-pattern>
 124                 <exclude-pattern>*/tests/phpunit/maintenance/*\.php</exclude-pattern>
 125                 <exclude-pattern>*/tests/phpunit/bootstrap\.php</exclude-pattern>
 126                 <exclude-pattern>*/tests/phpunit/phpunit\.php</exclude-pattern>
 127         </rule>
 128         <rule ref="MediaWiki.Files.ClassMatchesFilename.WrongCase">
 129                 <!--
 130                         Whitelist existing violations, but enable the sniff to prevent
 131                         any new occurrences.
 132                 -->
 133                 <exclude-pattern>*/maintenance/language/alltrans\.php</exclude-pattern>
 134                 <exclude-pattern>*/maintenance/language/digit2html\.php</exclude-pattern>
 135                 <exclude-pattern>*/maintenance/language/langmemusage\.php</exclude-pattern>
 136                 <exclude-pattern>*/maintenance/mctest\.php</exclude-pattern>
 137                 <exclude-pattern>*/maintenance/mergeMessageFileList\.php</exclude-pattern>
 138                 <exclude-pattern>*/maintenance/mwdocgen\.php</exclude-pattern>
 139                 <exclude-pattern>*/maintenance/rebuildall\.php</exclude-pattern>
 140                 <exclude-pattern>*/maintenance/rebuildmessages\.php</exclude-pattern>
 141                 <exclude-pattern>*/maintenance/rebuildrecentchanges\.php</exclude-pattern>
 142                 <exclude-pattern>*/maintenance/rebuildtextindex\.php</exclude-pattern>
 143                 <exclude-pattern>*/maintenance/storage/checkStorage\.php</exclude-pattern>
 144                 <exclude-pattern>*/maintenance/storage/recompressTracked\.php</exclude-pattern>
 145                 <exclude-pattern>*/maintenance/storage/trackBlobs\.php</exclude-pattern>
 146                 <!-- Skip violations in some tests for now -->
 147                 <exclude-pattern>*/tests/phpunit/unit/includes/GlobalFunctions/*\.php</exclude-pattern>
 148                 <exclude-pattern>*/tests/phpunit/includes/GlobalFunctions/*\.php</exclude-pattern>
 149                 <exclude-pattern>*/tests/phpunit/maintenance/*\.php</exclude-pattern>
 150                 <exclude-pattern>*/tests/phpunit/integration/includes/GlobalFunctions/*\.php</exclude-pattern>
 151         </rule>
 152
 153         <rule ref="Generic.Files.OneObjectStructurePerFile.MultipleFound">
 154                 <!--
 155                         Whitelist existing violations, but enable the sniff to prevent
 156                         any new occurrences.
 157                 -->
 158                 <exclude-pattern>*/maintenance/dumpIterator\.php</exclude-pattern>
 159                 <exclude-pattern>*/maintenance/Maintenance\.php</exclude-pattern>
 160                 <exclude-pattern>*/maintenance/findDeprecated\.php</exclude-pattern>
 161                 <exclude-pattern>*/maintenance/storage/recompressTracked\.php</exclude-pattern>
 162                 <exclude-pattern>*/maintenance/preprocessorFuzzTest\.php</exclude-pattern>
 163                 <exclude-pattern>*/maintenance/language/languages.inc</exclude-pattern>
 164                 <exclude-pattern>*/maintenance/language/StatOutputs\.php</exclude-pattern>
 165                 <exclude-pattern>*/maintenance/language/checkLanguage.inc</exclude-pattern>
 166                 <exclude-pattern>*/maintenance/language/generateCollationData\.php</exclude-pattern>
 167                 <exclude-pattern>*/maintenance/term/MWTerm\.php</exclude-pattern>
 168                 <!-- Language converters use the pattern of 2 classes in one file -->
 169                 <exclude-pattern>*/languages/*\.php</exclude-pattern>
 170                 <!-- We don't care that much about violations in tests -->
 171                 <exclude-pattern>*/tests/*\.php</exclude-pattern>
 172         </rule>
 173         <rule ref="PSR2.Methods.MethodDeclaration.Underscore">
 174                 <exclude-pattern>*/includes/StubObject\.php</exclude-pattern>
 175                 <exclude-pattern>*/includes/StubUserLang\.php</exclude-pattern>
 176         </rule>
 177         <rule ref="MediaWiki.Usage.AssignmentInReturn.AssignmentInReturn">
 178                 <exclude-pattern>*/tests/phpunit/*\.php</exclude-pattern>
 179         </rule>
 180         <rule ref="MediaWiki.Usage.ForbiddenFunctions.escapeshellarg">
 181                 <!--
 182                         Whitelist existing violations, but enable the sniff to prevent
 183                         any new occurrences.
 184                 -->
 185                 <exclude-pattern>*/includes/libs/filebackend/FSFileBackend\.php</exclude-pattern>
 186                 <exclude-pattern>*/includes/shell/Command\.php</exclude-pattern>
 187                 <exclude-pattern>*/includes/shell/Shell\.php</exclude-pattern>
 188         </rule>
 189         <rule ref="MediaWiki.Usage.ForbiddenFunctions.popen">
 190                 <!--
 191                         Whitelist existing violations, but enable the sniff to prevent
 192                         any new occurrences.
 193                 -->
 194                 <exclude-pattern>*/includes/GlobalFunctions\.php</exclude-pattern>
 195                 <exclude-pattern>*/includes/libs/filebackend/FSFileBackend\.php</exclude-pattern>
 196                 <exclude-pattern>*/maintenance/includes/SevenZipStream\.php</exclude-pattern>
 197                 <exclude-pattern>*/maintenance/populateImageSha1\.php</exclude-pattern>
 198         </rule>
 199         <rule ref="MediaWiki.Usage.ForbiddenFunctions.proc_open">
 200                 <!--
 201                         Whitelist existing violations, but enable the sniff to prevent
 202                         any new occurrences.
 203                 -->
 204                 <exclude-pattern>includes/export/DumpPipeOutput\.php</exclude-pattern>
 205                 <exclude-pattern>includes/resourceloader/ResourceLoaderImage\.php</exclude-pattern>
 206                 <exclude-pattern>includes/shell/Command\.php</exclude-pattern>
 207                 <exclude-pattern>maintenance/includes/TextPassDumper\.php</exclude-pattern>
 208                 <exclude-pattern>maintenance/mysql\.php</exclude-pattern>
 209                 <exclude-pattern>maintenance/storage/recompressTracked\.php</exclude-pattern>
 210                 <exclude-pattern>tests/parser/editTests\.php</exclude-pattern>
 211         </rule>
 212         <rule ref="MediaWiki.Usage.ForbiddenFunctions.shell_exec">
 213                 <!--
 214                         Whitelist existing violations, but enable the sniff to prevent
 215                         any new occurrences.
 216                 -->
 217                 <exclude-pattern>*/maintenance/mwdocgen\.php</exclude-pattern>
 218                 <exclude-pattern>*/maintenance/updateCredits\.php</exclude-pattern>
 219         </rule>
 220         <rule ref="MediaWiki.Usage.ForbiddenFunctions.system">
 221                 <!--
 222                         Whitelist existing violations, but enable the sniff to prevent
 223                         any new occurrences.
 224                 -->
 225                 <exclude-pattern>*/maintenance/mwdocgen\.php</exclude-pattern>
 226         </rule>
 227         <rule ref="MediaWiki.Commenting.MissingCovers.MissingCovers">
 228                 <exclude-pattern>tests/phpunit/structure/*</exclude-pattern>
 229         </rule>
 230         <file>.</file>
 231         <arg name="encoding" value="UTF-8"/>
 232         <arg name="extensions" value="php,php5,inc,sample"/>
 233         <exclude-pattern type="relative">^extensions/</exclude-pattern>
 234         <exclude-pattern type="relative">^skins/</exclude-pattern>
 235         <exclude-pattern>AdminSettings\.php</exclude-pattern>
 236         <exclude-pattern>LocalSettings\.php</exclude-pattern>
 237 </ruleset>