1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501 |
- <?php
- /**
- * PHP Code Style Fixer (config created for version 2.16.1 (Yellow Bird)).
- *
- * Use one of the following console commands to just see the
- * changes that will be made.
- * - `php-cs-fixer fix --config='.php_cs' --diff-format udiff --dry-run`
- * - `php '.php_cs'`
- *
- * Use one of the following console commands to fix PHP code:
- * - `php-cs-fixer fix --config='.php_cs' --diff-format udiff`
- * - `php '.php_cs' --force`
- *
- * @see https://cs.symfony.com/
- */
- $rules = [
- /*
- * Each line of multi-line DocComments must have an asterisk [PSR-5]
- * and must be aligned with the first one.
- */
- 'align_multiline_comment' => true,
- // Each element of an array must be indented exactly once.
- 'array_indentation' => true,
- // PHP arrays should be declared using the configured syntax.
- 'array_syntax' => [
- 'syntax' => 'short',
- ],
- /*
- * Converts backtick operators to `shell_exec` calls.
- *
- * Conversion is done only when it is non risky, so when special
- * chars like single-quotes, double-quotes and backticks are not
- * used inside the command.
- */
- 'backtick_to_shell_exec' => true,
- // Binary operators should be surrounded by space as configured.
- 'binary_operator_spaces' => true,
- // There MUST be one blank line after the namespace declaration.
- 'blank_line_after_namespace' => true,
- /*
- * Ensure there is no code on the same line as the PHP open tag and
- * it is followed by a blank line.
- */
- 'blank_line_after_opening_tag' => true,
- // An empty line feed must precede any configured statement.
- 'blank_line_before_statement' => [
- 'statements' => [
- 'continue',
- 'declare',
- 'return',
- 'throw',
- 'try',
- 'case',
- 'die',
- 'exit',
- 'do',
- 'foreach',
- 'goto',
- 'if',
- 'while',
- ],
- ],
- /*
- * The body of each structure MUST be enclosed by braces. Braces
- * should be properly placed. Body of braces should be properly
- * indented.
- */
- 'braces' => [
- 'allow_single_line_closure' => true,
- ],
- // A single space or none should be between cast and variable.
- 'cast_spaces' => true,
- /*
- * Class, trait and interface elements must be separated with one
- * blank line.
- */
- 'class_attributes_separation' => true,
- /*
- * Whitespace around the keywords of a class, trait or interfaces
- * definition should be one space.
- */
- 'class_definition' => [
- 'single_item_single_line' => true,
- ],
- // Converts `::class` keywords to FQCN strings.
- 'class_keyword_remove' => false,
- // Using `isset($var) &&` multiple times should be done in one call.
- 'combine_consecutive_issets' => true,
- // Calling `unset` on multiple items should be done in one call.
- 'combine_consecutive_unsets' => true,
- /*
- * Replace multiple nested calls of `dirname` by only one call with
- * second `$level` parameter. Requires PHP >= 7.0.
- *
- * Risky!
- * Risky when the function `dirname` is overridden.
- */
- 'combine_nested_dirname' => false,
- /*
- * Comments with annotation should be docblock when used on
- * structural elements.
- *
- * Risky!
- * Risky as new docblocks might mean more, e.g. a Doctrine entity
- * might have a new column in database
- */
- 'comment_to_phpdoc' => [
- 'ignored_tags' => [
- 'noinspection',
- ],
- ],
- /*
- * Remove extra spaces in a nullable typehint.
- *
- * Rule is applied only in a PHP 7.1+ environment.
- */
- 'compact_nullable_typehint' => false,
- // Concatenation should be spaced according configuration.
- 'concat_space' => [
- 'spacing' => 'one',
- ],
- /*
- * The PHP constants `true`, `false`, and `null` MUST be written
- * using the correct casing.
- */
- 'constant_case' => true,
- /*
- * Class `DateTimeImmutable` should be used instead of `DateTime`.
- *
- * Risky!
- * Risky when the code relies on modifying `DateTime` objects or if
- * any of the `date_create*` functions are overridden.
- */
- 'date_time_immutable' => true,
- /*
- * Equal sign in declare statement should be surrounded by spaces or
- * not following configuration.
- */
- 'declare_equal_normalize' => true,
- /*
- * Force strict types declaration in all files. Requires PHP >= 7.0.
- *
- * Risky!
- * Forcing strict types will stop non strict code from working.
- */
- 'declare_strict_types' => false,
- /*
- * Replaces `dirname(__FILE__)` expression with equivalent `__DIR__`
- * constant.
- *
- * Risky!
- * Risky when the function `dirname` is overridden.
- */
- 'dir_constant' => true,
- /*
- * Doctrine annotations must use configured operator for assignment
- * in arrays.
- */
- 'doctrine_annotation_array_assignment' => true,
- /*
- * Doctrine annotations without arguments must use the configured
- * syntax.
- */
- 'doctrine_annotation_braces' => true,
- // Doctrine annotations must be indented with four spaces.
- 'doctrine_annotation_indentation' => true,
- /*
- * Fixes spaces in Doctrine annotations.
- *
- * There must not be any space around parentheses; commas must be
- * preceded by no space and followed by one space; there must be no
- * space around named arguments assignment operator; there must be
- * one space around array assignment operator.
- */
- 'doctrine_annotation_spaces' => true,
- /*
- * The keyword `elseif` should be used instead of `else if` so that
- * all control keywords look like single words.
- */
- 'elseif' => true,
- // PHP code MUST use only UTF-8 without BOM (remove BOM).
- 'encoding' => true,
- /*
- * Replace deprecated `ereg` regular expression functions with
- * `preg`.
- *
- * Risky!
- * Risky if the `ereg` function is overridden.
- */
- 'ereg_to_preg' => true,
- /*
- * Error control operator should be added to deprecation notices
- * and/or removed from other cases.
- *
- * Risky!
- * Risky because adding/removing `@` might cause changes to code
- * behaviour or if `trigger_error` function is overridden.
- */
- 'error_suppression' => [
- 'mute_deprecation_error' => true,
- 'noise_remaining_usages' => true,
- 'noise_remaining_usages_exclude' => [
- 'fclose',
- 'fopen',
- 'gzinflate',
- 'iconv',
- 'mime_content_type',
- 'rename',
- 'unlink',
- ],
- ],
- /*
- * Escape implicit backslashes in strings and heredocs to ease the
- * understanding of which are special chars interpreted by PHP and
- * which not.
- *
- * In PHP double-quoted strings and heredocs some chars like `n`,
- * `$` or `u` have special meanings if preceded by a backslash (and
- * some are special only if followed by other special chars), while
- * a backslash preceding other chars are interpreted like a plain
- * backslash. The precise list of those special chars is hard to
- * remember and to identify quickly: this fixer escapes backslashes
- * that do not start a special interpretation with the char after
- * them.
- * It is possible to fix also single-quoted strings: in this case
- * there is no special chars apart from single-quote and backslash
- * itself, so the fixer simply ensure that all backslashes are
- * escaped. Both single and double backslashes are allowed in
- * single-quoted strings, so the purpose in this context is mainly
- * to have a uniformed way to have them written all over the
- * codebase.
- */
- 'escape_implicit_backslashes' => true,
- /*
- * Add curly braces to indirect variables to make them clear to
- * understand. Requires PHP >= 7.0.
- */
- 'explicit_indirect_variable' => false,
- /*
- * Converts implicit variables into explicit ones in double-quoted
- * strings or heredoc syntax.
- *
- * The reasoning behind this rule is the following:
- * - When there are two valid ways of doing the same thing, using
- * both is confusing, there should be a coding standard to follow
- * - PHP manual marks `"$var"` syntax as implicit and `"${var}"`
- * syntax as explicit: explicit code should always be preferred
- * - Explicit syntax allows word concatenation inside strings, e.g.
- * `"${var}IsAVar"`, implicit doesn't
- * - Explicit syntax is easier to detect for IDE/editors and
- * therefore has colors/hightlight with higher contrast, which is
- * easier to read
- * Backtick operator is skipped because it is harder to handle; you
- * can use `backtick_to_shell_exec` fixer to normalize backticks to
- * strings
- */
- 'explicit_string_variable' => true,
- /*
- * All classes must be final, except abstract ones and Doctrine
- * entities.
- *
- * No exception and no configuration are intentional. Beside
- * Doctrine entities and of course abstract classes, there is no
- * single reason not to declare all classes final. If you want to
- * subclass a class, mark the parent class as abstract and create
- * two child classes, one empty if necessary: you'll gain much more
- * fine grained type-hinting. If you need to mock a standalone
- * class, create an interface, or maybe it's a value-object that
- * shouldn't be mocked at all. If you need to extend a standalone
- * class, create an interface and use the Composite pattern. If you
- * aren't ready yet for serious OOP, go with
- * FinalInternalClassFixer, it's fine.
- *
- * Risky!
- * Risky when subclassing non-abstract classes.
- */
- 'final_class' => false,
- /*
- * Internal classes should be `final`.
- *
- * Risky!
- * Changing classes to `final` might cause code execution to break.
- */
- 'final_internal_class' => false,
- /*
- * All `public` methods of `abstract` classes should be `final`.
- *
- * Enforce API encapsulation in an inheritance architecture. If you
- * want to override a method, use the Template method pattern.
- *
- * Risky!
- * Risky when overriding `public` methods of `abstract` classes
- */
- 'final_public_method_for_abstract_class' => false,
- // Converts `static` access to `self` access in `final` classes.
- 'final_static_access' => true,
- /*
- * Order the flags in `fopen` calls, `b` and `t` must be last.
- *
- * Risky!
- * Risky when the function `fopen` is overridden.
- */
- 'fopen_flag_order' => true,
- /*
- * The flags in `fopen` calls must omit `t`, and `b` must be omitted
- * or included consistently.
- *
- * Risky!
- * Risky when the function `fopen` is overridden.
- */
- 'fopen_flags' => [
- 'b_mode' => true,
- ],
- /*
- * PHP code must use the long `<?php` tags or short-echo `<?=` tags
- * and not other tag variations.
- */
- 'full_opening_tag' => true,
- /*
- * Transforms imported FQCN parameters and return types in function
- * arguments to short version.
- */
- 'fully_qualified_strict_types' => true,
- // Spaces should be properly placed in a function declaration.
- 'function_declaration' => true,
- /*
- * Replace core functions calls returning constants with the
- * constants.
- *
- * Risky!
- * Risky when any of the configured functions to replace are
- * overridden.
- */
- 'function_to_constant' => [
- 'functions' => [
- 'get_class',
- 'php_sapi_name',
- 'phpversion',
- 'pi',
- 'get_called_class',
- ],
- ],
- // Ensure single space between function's argument and its typehint.
- 'function_typehint_space' => true,
- // Configured annotations should be omitted from PHPDoc.
- 'general_phpdoc_annotation_remove' => true,
- // Imports or fully qualifies global classes/functions/constants.
- 'global_namespace_import' => [
- 'import_constants' => false,
- 'import_functions' => false,
- 'import_classes' => false,
- ],
- // Add, replace or remove header comment.
- 'header_comment' => false,
- /*
- * Heredoc/nowdoc content must be properly indented. Requires PHP >=
- * 7.3.
- */
- 'heredoc_indentation' => false,
- // Convert `heredoc` to `nowdoc` where possible.
- 'heredoc_to_nowdoc' => true,
- /*
- * Function `implode` must be called with 2 arguments in the
- * documented order.
- *
- * Risky!
- * Risky when the function `implode` is overridden.
- */
- 'implode_call' => true,
- /*
- * Include/Require and file path should be divided with a single
- * space. File path should not be placed under brackets.
- */
- 'include' => true,
- /*
- * Pre- or post-increment and decrement operators should be used if
- * possible.
- */
- 'increment_style' => false,
- // Code MUST use configured indentation type.
- 'indentation_type' => true,
- /*
- * Replaces `is_null($var)` expression with `null === $var`.
- *
- * Risky!
- * Risky when the function `is_null` is overridden.
- */
- 'is_null' => true,
- // All PHP files must use same line ending.
- 'line_ending' => true,
- // Ensure there is no code on the same line as the PHP open tag.
- 'linebreak_after_opening_tag' => true,
- /*
- * List (`array` destructuring) assignment should be declared using
- * the configured syntax. Requires PHP >= 7.1.
- */
- 'list_syntax' => false,
- /*
- * Use `&&` and `||` logical operators instead of `and` and `or`.
- *
- * Risky!
- * Risky, because you must double-check if using and/or with lower
- * precedence was intentional.
- */
- 'logical_operators' => true,
- // Cast should be written in lower case.
- 'lowercase_cast' => true,
- // PHP keywords MUST be in lower case.
- 'lowercase_keywords' => true,
- /*
- * Class static references `self`, `static` and `parent` MUST be in
- * lower case.
- */
- 'lowercase_static_reference' => true,
- // Magic constants should be referred to using the correct casing.
- 'magic_constant_casing' => true,
- /*
- * Magic method definitions and calls must be using the correct
- * casing.
- */
- 'magic_method_casing' => true,
- /*
- * Replace non multibyte-safe functions with corresponding mb
- * function.
- *
- * Risky!
- * Risky when any of the functions are overridden.
- */
- 'mb_str_functions' => false,
- /*
- * In method arguments and method call, there MUST NOT be a space
- * before each comma and there MUST be one space after each comma.
- * Argument lists MAY be split across multiple lines, where each
- * subsequent line is indented once. When doing so, the first item
- * in the list MUST be on the next line, and there MUST be only one
- * argument per line.
- */
- 'method_argument_space' => [
- 'on_multiline' => 'ensure_fully_multiline',
- ],
- /*
- * Method chaining MUST be properly indented. Method chaining with
- * different levels of indentation is not supported.
- */
- 'method_chaining_indentation' => true,
- /*
- * Replaces `intval`, `floatval`, `doubleval`, `strval` and
- * `boolval` function calls with according type casting operator.
- *
- * Risky!
- * Risky if any of the functions `intval`, `floatval`, `doubleval`,
- * `strval` or `boolval` are overridden.
- */
- 'modernize_types_casting' => true,
- /*
- * DocBlocks must start with two asterisks, multiline comments must
- * start with a single asterisk, after the opening slash. Both must
- * end with a single asterisk before the closing slash.
- */
- 'multiline_comment_opening_closing' => true,
- /*
- * Forbid multi-line whitespace before the closing semicolon or move
- * the semicolon to the new line for chained calls.
- */
- 'multiline_whitespace_before_semicolons' => [
- 'strategy' => 'new_line_for_chained_calls',
- ],
- /*
- * Add leading `\` before constant invocation of internal constant
- * to speed up resolving. Constant name match is case-sensitive,
- * except for `null`, `false` and `true`.
- *
- * Risky!
- * Risky when any of the constants are namespaced or overridden.
- */
- 'native_constant_invocation' => true,
- /*
- * Function defined by PHP should be called using the correct
- * casing.
- */
- 'native_function_casing' => true,
- /*
- * Add leading `\` before function invocation to speed up resolving.
- *
- * Risky!
- * Risky when any of the functions are overridden.
- */
- 'native_function_invocation' => [
- 'include' => [
- '@compiler_optimized',
- ],
- 'scope' => 'namespaced',
- 'strict' => true,
- ],
- // Native type hints for functions should use the correct case.
- 'native_function_type_declaration_casing' => true,
- /*
- * All instances created with new keyword must be followed by
- * braces.
- */
- 'new_with_braces' => true,
- /*
- * Master functions shall be used instead of aliases.
- *
- * Risky!
- * Risky when any of the alias functions are overridden.
- */
- 'no_alias_functions' => [
- 'sets' => [
- '@all',
- ],
- ],
- // Replace control structure alternative syntax to use braces.
- 'no_alternative_syntax' => true,
- // There should not be a binary flag before strings.
- 'no_binary_string' => true,
- // There should be no empty lines after class opening brace.
- 'no_blank_lines_after_class_opening' => true,
- /*
- * There should not be blank lines between docblock and the
- * documented element.
- */
- 'no_blank_lines_after_phpdoc' => true,
- // There should be no blank lines before a namespace declaration.
- 'no_blank_lines_before_namespace' => false,
- /*
- * There must be a comment when fall-through is intentional in a
- * non-empty case body.
- *
- * Adds a "no break" comment before fall-through cases, and removes
- * it if there is no fall-through.
- */
- 'no_break_comment' => [
- 'comment_text' => 'no break',
- ],
- /*
- * The closing `?>` tag MUST be omitted from files containing only
- * PHP.
- */
- 'no_closing_tag' => true,
- // There should not be any empty comments.
- 'no_empty_comment' => true,
- // There should not be empty PHPDoc blocks.
- 'no_empty_phpdoc' => true,
- // Remove useless semicolon statements.
- 'no_empty_statement' => true,
- /*
- * Removes extra blank lines and/or blank lines following
- * configuration.
- */
- 'no_extra_blank_lines' => [
- 'tokens' => [
- 'extra',
- 'case',
- 'continue',
- 'default',
- 'curly_brace_block',
- 'parenthesis_brace_block',
- 'return',
- 'square_brace_block',
- 'use',
- 'throw',
- 'use_trait',
- 'useTrait',
- 'switch',
- ],
- ],
- /*
- * Replace accidental usage of homoglyphs (non ascii characters) in
- * names.
- *
- * Risky!
- * Renames classes and cannot rename the files. You might have
- * string references to renamed code (`$$name`).
- */
- 'no_homoglyph_names' => true,
- // Remove leading slashes in `use` clauses.
- 'no_leading_import_slash' => true,
- /*
- * The namespace declaration line shouldn't contain leading
- * whitespace.
- */
- 'no_leading_namespace_whitespace' => true,
- // Either language construct `print` or `echo` should be used.
- 'no_mixed_echo_print' => true,
- // Operator `=>` should not be surrounded by multi-line whitespaces.
- 'no_multiline_whitespace_around_double_arrow' => true,
- /*
- * Properties MUST not be explicitly initialized with `null` except
- * when they have a type declaration (PHP 7.4).
- */
- 'no_null_property_initialization' => true,
- /*
- * Convert PHP4-style constructors to `__construct`.
- *
- * Risky!
- * Risky when old style constructor being fixed is overridden or
- * overrides parent one.
- */
- 'no_php4_constructor' => true,
- /*
- * Short cast `bool` using double exclamation mark should not be
- * used.
- */
- 'no_short_bool_cast' => true,
- // Replace short-echo `<?=` with long format `<?php echo` syntax.
- 'no_short_echo_tag' => false,
- // Single-line whitespace before closing semicolon are prohibited.
- 'no_singleline_whitespace_before_semicolons' => true,
- /*
- * When making a method or function call, there MUST NOT be a space
- * between the method or function name and the opening parenthesis.
- */
- 'no_spaces_after_function_name' => true,
- // There MUST NOT be spaces around offset braces.
- 'no_spaces_around_offset' => true,
- /*
- * There MUST NOT be a space after the opening parenthesis. There
- * MUST NOT be a space before the closing parenthesis.
- */
- 'no_spaces_inside_parenthesis' => true,
- // Replaces superfluous `elseif` with `if`.
- 'no_superfluous_elseif' => true,
- /*
- * Removes `@param` and `@return` tags that don't provide any useful
- * information.
- */
- 'no_superfluous_phpdoc_tags' => false,
- // Remove trailing commas in list function calls.
- 'no_trailing_comma_in_list_call' => true,
- // PHP single-line arrays should not have trailing comma.
- 'no_trailing_comma_in_singleline_array' => true,
- // Remove trailing whitespace at the end of non-blank lines.
- 'no_trailing_whitespace' => true,
- // There MUST be no trailing spaces inside comment or PHPDoc.
- 'no_trailing_whitespace_in_comment' => true,
- // Removes unneeded parentheses around control statements.
- 'no_unneeded_control_parentheses' => true,
- /*
- * Removes unneeded curly braces that are superfluous and aren't
- * part of a control structure's body.
- */
- 'no_unneeded_curly_braces' => true,
- // A final class must not have final methods.
- 'no_unneeded_final_method' => true,
- /*
- * In function arguments there must not be arguments with default
- * values before non-default ones.
- *
- * Risky!
- * Modifies the signature of functions; therefore risky when using
- * systems (such as some Symfony components) that rely on those (for
- * example through reflection).
- */
- 'no_unreachable_default_argument_value' => false,
- // Variables must be set `null` instead of using `(unset)` casting.
- 'no_unset_cast' => true,
- /*
- * Properties should be set to `null` instead of using `unset`.
- *
- * Risky!
- * Changing variables to `null` instead of unsetting them will mean
- * they still show up when looping over class variables. With PHP
- * 7.4, this rule might introduce `null` assignments to property
- * whose type declaration does not allow it.
- */
- 'no_unset_on_property' => false,
- // Unused `use` statements must be removed.
- 'no_unused_imports' => true,
- // There should not be useless `else` cases.
- 'no_useless_else' => true,
- /*
- * There should not be an empty `return` statement at the end of a
- * function.
- */
- 'no_useless_return' => true,
- /*
- * In array declaration, there MUST NOT be a whitespace before each
- * comma.
- */
- 'no_whitespace_before_comma_in_array' => true,
- // Remove trailing whitespace at the end of blank lines.
- 'no_whitespace_in_blank_line' => true,
- /*
- * Remove Zero-width space (ZWSP), Non-breaking space (NBSP) and
- * other invisible unicode symbols.
- *
- * Risky!
- * Risky when strings contain intended invisible characters.
- */
- 'non_printable_character' => true,
- // Array index should always be written by using square braces.
- 'normalize_index_brace' => true,
- /*
- * Logical NOT operators (`!`) should have leading and trailing
- * whitespaces.
- */
- 'not_operator_with_space' => false,
- // Logical NOT operators (`!`) should have one trailing whitespace.
- 'not_operator_with_successor_space' => false,
- /*
- * Adds or removes `?` before type declarations for parameters with
- * a default `null` value.
- *
- * Rule is applied only in a PHP 7.1+ environment.
- */
- 'nullable_type_declaration_for_default_null_value' => false,
- /*
- * There should not be space before or after object
- * `T_OBJECT_OPERATOR` `->`.
- */
- 'object_operator_without_whitespace' => true,
- // Orders the elements of classes/interfaces/traits.
- 'ordered_class_elements' => false,
- // Ordering `use` statements.
- 'ordered_imports' => [
- 'sort_algorithm' => 'alpha',
- 'imports_order' => [
- 'class',
- 'const',
- 'function',
- ],
- ],
- /*
- * Orders the interfaces in an `implements` or `interface extends`
- * clause.
- *
- * Risky!
- * Risky for `implements` when specifying both an interface and its
- * parent interface, because PHP doesn't break on `parent, child`
- * but does on `child, parent`.
- */
- 'ordered_interfaces' => false,
- /*
- * PHPUnit assertion method calls like `->assertSame(true, $foo)`
- * should be written with dedicated method like
- * `->assertTrue($foo)`.
- *
- * Risky!
- * Fixer could be risky if one is overriding PHPUnit's native
- * methods.
- */
- 'php_unit_construct' => true,
- /*
- * PHPUnit assertions like `assertInternalType`, `assertFileExists`,
- * should be used over `assertTrue`.
- *
- * Risky!
- * Fixer could be risky if one is overriding PHPUnit's native
- * methods.
- */
- 'php_unit_dedicate_assert' => [
- 'target' => '3.5',
- ],
- /*
- * PHPUnit assertions like `assertIsArray` should be used over
- * `assertInternalType`.
- *
- * Risky!
- * Risky when PHPUnit methods are overridden or when project has
- * PHPUnit incompatibilities.
- */
- 'php_unit_dedicate_assert_internal_type' => false,
- /*
- * Usages of `->setExpectedException*` methods MUST be replaced by
- * `->expectException*` methods.
- *
- * Risky!
- * Risky when PHPUnit classes are overridden or not accessible, or
- * when project has PHPUnit incompatibilities.
- */
- 'php_unit_expectation' => false,
- // PHPUnit annotations should be a FQCNs including a root namespace.
- 'php_unit_fqcn_annotation' => true,
- // All PHPUnit test classes should be marked as internal.
- 'php_unit_internal_class' => true,
- /*
- * Enforce camel (or snake) case for PHPUnit test methods, following
- * configuration.
- */
- 'php_unit_method_casing' => true,
- /*
- * Usages of `->getMock` and
- * `->getMockWithoutInvokingTheOriginalConstructor` methods MUST be
- * replaced by `->createMock` or `->createPartialMock` methods.
- *
- * Risky!
- * Risky when PHPUnit classes are overridden or not accessible, or
- * when project has PHPUnit incompatibilities.
- */
- 'php_unit_mock' => false,
- /*
- * Usage of PHPUnit's mock e.g. `->will($this->returnValue(..))`
- * must be replaced by its shorter equivalent such as
- * `->willReturn(...)`.
- *
- * Risky!
- * Risky when PHPUnit classes are overridden or not accessible, or
- * when project has PHPUnit incompatibilities.
- */
- 'php_unit_mock_short_will_return' => false,
- /*
- * PHPUnit classes MUST be used in namespaced version, e.g.
- * `\PHPUnit\Framework\TestCase` instead of
- * `\PHPUnit_Framework_TestCase`.
- *
- * PHPUnit v6 has finally fully switched to namespaces.
- * You could start preparing the upgrade by switching from
- * non-namespaced TestCase to namespaced one.
- * Forward compatibility layer (`\PHPUnit\Framework\TestCase` class)
- * was backported to PHPUnit v4.8.35 and PHPUnit v5.4.0.
- * Extended forward compatibility layer (`PHPUnit\Framework\Assert`,
- * `PHPUnit\Framework\BaseTestListener`,
- * `PHPUnit\Framework\TestListener` classes) was introduced in
- * v5.7.0.
- *
- * Risky!
- * Risky when PHPUnit classes are overridden or not accessible, or
- * when project has PHPUnit incompatibilities.
- */
- 'php_unit_namespaced' => [
- 'target' => '4.8',
- ],
- /*
- * Usages of `@expectedException*` annotations MUST be replaced by
- * `->setExpectedException*` methods.
- *
- * Risky!
- * Risky when PHPUnit classes are overridden or not accessible, or
- * when project has PHPUnit incompatibilities.
- */
- 'php_unit_no_expectation_annotation' => [
- 'target' => 'newest',
- ],
- // Order `@covers` annotation of PHPUnit tests.
- 'php_unit_ordered_covers' => true,
- /*
- * Changes the visibility of the `setUp()` and `tearDown()`
- * functions of PHPUnit to `protected`, to match the PHPUnit
- * TestCase.
- *
- * Risky!
- * This fixer may change functions named `setUp()` or `tearDown()`
- * outside of PHPUnit tests, when a class is wrongly seen as a
- * PHPUnit test.
- */
- 'php_unit_set_up_tear_down_visibility' => true,
- /*
- * All PHPUnit test cases should have `@small`, `@medium` or
- * `@large` annotation to enable run time limits.
- *
- * The special groups [small, medium, large] provides a way to
- * identify tests that are taking long to be executed.
- */
- 'php_unit_size_class' => true,
- /*
- * PHPUnit methods like `assertSame` should be used instead of
- * `assertEquals`.
- *
- * Risky!
- * Risky when any of the functions are overridden or when testing
- * object equality.
- */
- 'php_unit_strict' => false,
- /*
- * Adds or removes @test annotations from tests, following
- * configuration.
- *
- * Risky!
- * This fixer may change the name of your tests, and could cause
- * incompatibility with abstract classes or interfaces.
- */
- 'php_unit_test_annotation' => true,
- /*
- * Calls to `PHPUnit\Framework\TestCase` static methods must all be
- * of the same type, either `$this->`, `self::` or `static::`.
- *
- * Risky!
- * Risky when PHPUnit methods are overridden or not accessible, or
- * when project has PHPUnit incompatibilities.
- */
- 'php_unit_test_case_static_method_calls' => true,
- /*
- * Adds a default `@coversNothing` annotation to PHPUnit test
- * classes that have no `@covers*` annotation.
- */
- 'php_unit_test_class_requires_covers' => false,
- // PHPDoc should contain `@param` for all params.
- 'phpdoc_add_missing_param_annotation' => [
- 'only_untyped' => false,
- ],
- /*
- * All items of the given phpdoc tags must be either left-aligned or
- * (by default) aligned vertically.
- */
- 'phpdoc_align' => [
- 'tags' => [
- 'return',
- 'throws',
- 'type',
- 'var',
- 'property',
- 'method',
- 'param',
- ],
- 'align' => 'vertical',
- ],
- // PHPDoc annotation descriptions should not be a sentence.
- 'phpdoc_annotation_without_dot' => true,
- /*
- * Docblocks should have the same indentation as the documented
- * subject.
- */
- 'phpdoc_indent' => true,
- // Fix PHPDoc inline tags, make `@inheritdoc` always inline.
- 'phpdoc_inline_tag' => true,
- /*
- * Changes doc blocks from single to multi line, or reversed. Works
- * for class constants, properties and methods only.
- */
- 'phpdoc_line_span' => [
- 'const' => 'single',
- 'property' => 'single',
- 'method' => 'multi',
- ],
- // `@access` annotations should be omitted from PHPDoc.
- 'phpdoc_no_access' => true,
- // No alias PHPDoc tags should be used.
- 'phpdoc_no_alias_tag' => true,
- /*
- * `@return void` and `@return null` annotations should be omitted
- * from PHPDoc.
- */
- 'phpdoc_no_empty_return' => true,
- /*
- * `@package` and `@subpackage` annotations should be omitted from
- * PHPDoc.
- */
- 'phpdoc_no_package' => true,
- // Classy that does not inherit must not have `@inheritdoc` tags.
- 'phpdoc_no_useless_inheritdoc' => true,
- /*
- * Annotations in PHPDoc should be ordered so that `@param`
- * annotations come first, then `@throws` annotations, then
- * `@return` annotations.
- */
- 'phpdoc_order' => true,
- /*
- * The type of `@return` annotations of methods returning a
- * reference to itself must the configured one.
- */
- 'phpdoc_return_self_reference' => true,
- /*
- * Scalar types should always be written in the same form. `int` not
- * `integer`, `bool` not `boolean`, `float` not `real` or `double`.
- */
- 'phpdoc_scalar' => true,
- /*
- * Annotations in PHPDoc should be grouped together so that
- * annotations of the same type immediately follow each other, and
- * annotations of a different type are separated by a single blank
- * line.
- */
- 'phpdoc_separation' => true,
- // Single line `@var` PHPDoc should have proper spacing.
- 'phpdoc_single_line_var_spacing' => true,
- /*
- * PHPDoc summary should end in either a full stop, exclamation
- * mark, or question mark.
- */
- 'phpdoc_summary' => true,
- // Docblocks should only be used on structural elements.
- 'phpdoc_to_comment' => false,
- /*
- * EXPERIMENTAL: Takes `@param` annotations of non-mixed types and
- * adjusts accordingly the function signature. Requires PHP >= 7.0.
- *
- * Risky!
- * [1] This rule is EXPERIMENTAL and is not covered with backward
- * compatibility promise. [2] `@param` annotation is mandatory for
- * the fixer to make changes, signatures of methods without it (no
- * docblock, inheritdocs) will not be fixed. [3] Manual actions are
- * required if inherited signatures are not properly documented.
- */
- 'phpdoc_to_param_type' => false,
- /*
- * EXPERIMENTAL: Takes `@return` annotation of non-mixed types and
- * adjusts accordingly the function signature. Requires PHP >= 7.0.
- *
- * Risky!
- * [1] This rule is EXPERIMENTAL and is not covered with backward
- * compatibility promise. [2] `@return` annotation is mandatory for
- * the fixer to make changes, signatures of methods without it (no
- * docblock, inheritdocs) will not be fixed. [3] Manual actions are
- * required if inherited signatures are not properly documented. [4]
- * `@inheritdocs` support is under construction.
- */
- 'phpdoc_to_return_type' => false,
- /*
- * PHPDoc should start and end with content, excluding the very
- * first and last line of the docblocks.
- */
- 'phpdoc_trim' => true,
- /*
- * Removes extra blank lines after summary and after description in
- * PHPDoc.
- */
- 'phpdoc_trim_consecutive_blank_line_separation' => true,
- // The correct case must be used for standard PHP types in PHPDoc.
- 'phpdoc_types' => true,
- // Sorts PHPDoc types.
- 'phpdoc_types_order' => [
- 'sort_algorithm' => 'none',
- 'null_adjustment' => 'always_last',
- ],
- /*
- * `@var` and `@type` annotations must have type and name in the
- * correct order.
- */
- 'phpdoc_var_annotation_correct_order' => true,
- /*
- * `@var` and `@type` annotations should not contain the variable
- * name.
- */
- 'phpdoc_var_without_name' => false,
- /*
- * Converts `pow` to the `**` operator.
- *
- * Risky!
- * Risky when the function `pow` is overridden.
- */
- 'pow_to_exponentiation' => false,
- /*
- * Converts `protected` variables and methods to `private` where
- * possible.
- */
- 'protected_to_private' => true,
- /*
- * Classes must be in a path that matches their namespace, be at
- * least one namespace deep and the class name should match the file
- * name.
- *
- * Risky!
- * This fixer may change your class name, which will break the code
- * that depends on the old name.
- */
- 'psr0' => false,
- /*
- * Class names should match the file name.
- *
- * Risky!
- * This fixer may change your class name, which will break the code
- * that depends on the old name.
- */
- 'psr4' => true,
- /*
- * Replaces `rand`, `srand`, `getrandmax` functions calls with their
- * `mt_*` analogs.
- *
- * Risky!
- * Risky when the configured functions are overridden.
- */
- 'random_api_migration' => [
- 'replacements' => [
- 'getrandmax' => 'mt_getrandmax',
- 'rand' => 'mt_rand',
- 'srand' => 'mt_srand',
- ],
- ],
- /*
- * Local, dynamic and directly referenced variables should not be
- * assigned and directly returned by a function or method.
- */
- 'return_assignment' => true,
- /*
- * There should be one or no space before colon, and one space after
- * it in return type declarations, according to configuration.
- *
- * Rule is applied only in a PHP 7+ environment.
- */
- 'return_type_declaration' => false,
- /*
- * Inside class or interface element `self` should be preferred to
- * the class name itself.
- *
- * Risky!
- * Risky when using dynamic calls like get_called_class() or late
- * static binding.
- */
- 'self_accessor' => true,
- /*
- * Inside a `final` class or anonymous class `self` should be
- * preferred to `static`.
- */
- 'self_static_accessor' => true,
- // Instructions must be terminated with a semicolon.
- 'semicolon_after_instruction' => true,
- /*
- * Cast shall be used, not `settype`.
- *
- * Risky!
- * Risky when the `settype` function is overridden or when used as
- * the 2nd or 3rd expression in a `for` loop .
- */
- 'set_type_to_cast' => true,
- /*
- * Cast `(boolean)` and `(integer)` should be written as `(bool)`
- * and `(int)`, `(double)` and `(real)` as `(float)`, `(binary)` as
- * `(string)`.
- */
- 'short_scalar_cast' => true,
- /*
- * Converts explicit variables in double-quoted strings and heredoc
- * syntax from simple to complex format (`${` to `{$`).
- *
- * Doesn't touch implicit variables. Works together nicely with
- * `explicit_string_variable`.
- */
- 'simple_to_complex_string_variable' => true,
- /*
- * A return statement wishing to return `void` should not return
- * `null`.
- */
- 'simplified_null_return' => false,
- /*
- * A PHP file without end tag must always end with a single empty
- * line feed.
- */
- 'single_blank_line_at_eof' => true,
- /*
- * There should be exactly one blank line before a namespace
- * declaration.
- */
- 'single_blank_line_before_namespace' => true,
- /*
- * There MUST NOT be more than one property or constant declared per
- * statement.
- */
- 'single_class_element_per_statement' => true,
- // There MUST be one use keyword per declaration.
- 'single_import_per_statement' => true,
- /*
- * Each namespace use MUST go on its own line and there MUST be one
- * blank line after the use statements block.
- */
- 'single_line_after_imports' => true,
- /*
- * Single-line comments and multi-line comments with only one line
- * of actual content should use the `//` syntax.
- */
- 'single_line_comment_style' => true,
- // Throwing exception must be done in single line.
- 'single_line_throw' => false,
- // Convert double quotes to single quotes for simple strings.
- 'single_quote' => [
- 'strings_containing_single_quote_chars' => false,
- ],
- // Each trait `use` must be done as single statement.
- 'single_trait_insert_per_statement' => true,
- // Fix whitespace after a semicolon.
- 'space_after_semicolon' => true,
- // Increment and decrement operators should be used if possible.
- 'standardize_increment' => true,
- // Replace all `<>` with `!=`.
- 'standardize_not_equals' => true,
- /*
- * Lambdas not (indirect) referencing `$this` must be declared
- * `static`.
- *
- * Risky!
- * Risky when using "->bindTo" on lambdas without referencing to
- * `$this`.
- */
- 'static_lambda' => true,
- /*
- * Comparisons should be strict.
- *
- * Risky!
- * Changing comparisons to strict might change code behavior.
- */
- 'strict_comparison' => false,
- /*
- * Functions should be used with `$strict` param set to `true`.
- *
- * The functions "array_keys", "array_search", "base64_decode",
- * "in_array" and "mb_detect_encoding" should be used with $strict
- * param.
- *
- * Risky!
- * Risky when the fixed function is overridden or if the code relies
- * on non-strict usage.
- */
- 'strict_param' => false,
- /*
- * All multi-line strings must use correct line ending.
- *
- * Risky!
- * Changing the line endings of multi-line strings might affect
- * string comparisons and outputs.
- */
- 'string_line_ending' => true,
- // A case should be followed by a colon and not a semicolon.
- 'switch_case_semicolon_to_colon' => true,
- // Removes extra spaces between colon and case value.
- 'switch_case_space' => true,
- // Standardize spaces around ternary operator.
- 'ternary_operator_spaces' => true,
- /*
- * Use `null` coalescing operator `??` where possible. Requires PHP
- * >= 7.0.
- */
- 'ternary_to_null_coalescing' => false,
- // PHP multi-line arrays should have a trailing comma.
- 'trailing_comma_in_multiline_array' => true,
- /*
- * Arrays should be formatted like function/method arguments,
- * without leading or trailing single line space.
- */
- 'trim_array_spaces' => true,
- // Unary operators should be placed adjacent to their operands.
- 'unary_operator_spaces' => true,
- /*
- * Visibility MUST be declared on all properties and methods;
- * `abstract` and `final` MUST be declared before the visibility;
- * `static` MUST be declared after the visibility.
- */
- 'visibility_required' => true,
- /*
- * Add `void` return type to functions with missing or empty return
- * statements, but priority is given to `@return` annotations.
- * Requires PHP >= 7.1.
- *
- * Risky!
- * Modifies the signature of functions.
- */
- 'void_return' => false,
- /*
- * In array declaration, there MUST be a whitespace after each
- * comma.
- */
- 'whitespace_after_comma_in_array' => true,
- /*
- * Write conditions in Yoda style (`true`), non-Yoda style (`false`)
- * or ignore those conditions (`null`) based on configuration.
- */
- 'yoda_style' => [
- 'equal' => false,
- 'identical' => false,
- 'less_and_greater' => false,
- ],
- ];
- if (\PHP_SAPI === 'cli' && !class_exists(\PhpCsFixer\Config::class)) {
- $binFixer = __DIR__ . '/vendor/bin/php-cs-fixer';
- if (!is_file($binFixer)) {
- $binFixer = 'php-cs-fixer';
- }
- $dryRun = !\in_array('--force', $_SERVER['argv'], true);
- $command = escapeshellarg($binFixer) . ' fix --config ' . escapeshellarg(__FILE__) . ' --diff-format udiff --ansi';
- if ($dryRun) {
- $command .= ' --dry-run';
- }
- system($command, $returnCode);
- if ($dryRun || $returnCode === 8) {
- fwrite(\STDOUT, "\n\e[1;40;93m\e[K\n");
- fwrite(\STDOUT, " [DEBUG] Dry run php-cs-fixer config.\e[K\n");
- fwrite(\STDOUT, " Only shows which files would have been modified.\e[K\n");
- fwrite(\STDOUT, " To apply the rules, use the --force option:\e[K\n\e[K\n");
- fwrite(\STDOUT, " \e[1;40;92mphp {$_SERVER['argv'][0]} --force\e[K\n\e[0m\n");
- } elseif ($returnCode !== 0) {
- fwrite(\STDERR, "\n\e[1;41;97m\e[K\n ERROR CODE: {$returnCode}\e[K\n\e[0m\n");
- }
- exit($returnCode);
- }
- return \PhpCsFixer\Config::create()
- ->setUsingCache(true)
- ->setCacheFile(__DIR__ . '/.php_cs.cache')
- ->setRules($rules)
- ->setRiskyAllowed(true)
- ->setFinder(
- \PhpCsFixer\Finder::create()
- ->in(__DIR__)
- )
- ;
|