fuc-new/vendor/slevomat/coding-standard/SlevomatCodingStandard/Sniffs/ControlStructures/RequireMultiLineConditionSniff.php
2026-05-02 16:20:44 +08:00

189 lines
6.0 KiB
PHP

<?php declare(strict_types = 1);
namespace SlevomatCodingStandard\Sniffs\ControlStructures;
use PHP_CodeSniffer\Files\File;
use PHP_CodeSniffer\Util\Tokens;
use SlevomatCodingStandard\Helpers\FixerHelper;
use SlevomatCodingStandard\Helpers\IndentationHelper;
use SlevomatCodingStandard\Helpers\SniffSettingsHelper;
use SlevomatCodingStandard\Helpers\TokenHelper;
use function count;
use function in_array;
use function sprintf;
use function strlen;
use const T_CLOSE_PARENTHESIS;
use const T_OPEN_PARENTHESIS;
class RequireMultiLineConditionSniff extends AbstractLineCondition
{
public const CODE_REQUIRED_MULTI_LINE_CONDITION = 'RequiredMultiLineCondition';
/** @var int */
public $minLineLength = 121;
/** @var bool */
public $booleanOperatorOnPreviousLine = false;
/** @var bool */
public $alwaysSplitAllConditionParts = false;
/**
* @phpcsSuppress SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingNativeTypeHint
* @param int $controlStructurePointer
*/
public function process(File $phpcsFile, $controlStructurePointer): void
{
$this->minLineLength = SniffSettingsHelper::normalizeInteger($this->minLineLength);
if ($this->shouldBeSkipped($phpcsFile, $controlStructurePointer)) {
return;
}
$tokens = $phpcsFile->getTokens();
$parenthesisOpenerPointer = $tokens[$controlStructurePointer]['parenthesis_opener'];
$parenthesisCloserPointer = $tokens[$controlStructurePointer]['parenthesis_closer'];
$booleanOperatorPointers = TokenHelper::findNextAll(
$phpcsFile,
Tokens::$booleanOperators,
$parenthesisOpenerPointer + 1,
$parenthesisCloserPointer
);
if ($booleanOperatorPointers === []) {
return;
}
$conditionStartPointer = TokenHelper::findNextEffective($phpcsFile, $parenthesisOpenerPointer + 1);
$conditionEndPointer = TokenHelper::findPreviousEffective($phpcsFile, $parenthesisCloserPointer - 1);
$conditionStartsOnNewLine = $tokens[$parenthesisOpenerPointer]['line'] !== $tokens[$conditionStartPointer]['line'];
$conditionEndsOnNewLine = $tokens[$parenthesisCloserPointer]['line'] !== $tokens[$conditionEndPointer]['line'];
$lineStart = $this->getLineStart($phpcsFile, $conditionStartsOnNewLine ? $conditionStartPointer - 1 : $parenthesisOpenerPointer);
$lineEnd = $this->getLineEnd($phpcsFile, $conditionEndsOnNewLine ? $conditionEndPointer + 1 : $parenthesisCloserPointer);
$condition = $this->getCondition($phpcsFile, $parenthesisOpenerPointer, $parenthesisCloserPointer);
$lineLength = strlen($lineStart . $condition . $lineEnd);
$conditionLinesCount = $tokens[$conditionEndPointer]['line'] - $tokens[$conditionStartPointer]['line'] + 1;
if (!$this->shouldReportError($lineLength, $conditionLinesCount, count($booleanOperatorPointers))) {
return;
}
$fix = $phpcsFile->addFixableError(
sprintf(
'Condition of "%s" should be split to more lines so each condition part is on its own line.',
$this->getControlStructureName($phpcsFile, $controlStructurePointer)
),
$controlStructurePointer,
self::CODE_REQUIRED_MULTI_LINE_CONDITION
);
if (!$fix) {
return;
}
$controlStructureIndentation = IndentationHelper::getIndentation(
$phpcsFile,
$conditionStartsOnNewLine
? $conditionStartPointer
: TokenHelper::findFirstNonWhitespaceOnLine($phpcsFile, $parenthesisOpenerPointer)
);
$conditionIndentation = $conditionStartsOnNewLine
? $controlStructureIndentation
: IndentationHelper::addIndentation($controlStructureIndentation);
$innerConditionLevel = 0;
$phpcsFile->fixer->beginChangeset();
if (!$conditionStartsOnNewLine) {
FixerHelper::removeWhitespaceBefore($phpcsFile, $conditionStartPointer);
$phpcsFile->fixer->addContentBefore($conditionStartPointer, $phpcsFile->eolChar . $conditionIndentation);
}
for ($i = $conditionStartPointer; $i <= $conditionEndPointer; $i++) {
if ($tokens[$i]['code'] === T_OPEN_PARENTHESIS) {
$containsBooleanOperator = TokenHelper::findNext(
$phpcsFile,
Tokens::$booleanOperators,
$i + 1,
$tokens[$i]['parenthesis_closer']
) !== null;
$innerConditionLevel++;
if ($containsBooleanOperator) {
FixerHelper::removeWhitespaceAfter($phpcsFile, $i);
$phpcsFile->fixer->addContent(
$i,
$phpcsFile->eolChar . IndentationHelper::addIndentation($conditionIndentation, $innerConditionLevel)
);
FixerHelper::removeWhitespaceBefore($phpcsFile, $tokens[$i]['parenthesis_closer']);
$phpcsFile->fixer->addContentBefore(
$tokens[$i]['parenthesis_closer'],
$phpcsFile->eolChar . IndentationHelper::addIndentation($conditionIndentation, $innerConditionLevel - 1)
);
}
continue;
}
if ($tokens[$i]['code'] === T_CLOSE_PARENTHESIS) {
$innerConditionLevel--;
continue;
}
if (!in_array($tokens[$i]['code'], Tokens::$booleanOperators, true)) {
continue;
}
$innerConditionIndentation = $conditionIndentation;
if ($innerConditionLevel > 0) {
$innerConditionIndentation = IndentationHelper::addIndentation($innerConditionIndentation, $innerConditionLevel);
}
if ($this->booleanOperatorOnPreviousLine) {
$phpcsFile->fixer->addContent($i, $phpcsFile->eolChar . $innerConditionIndentation);
FixerHelper::removeWhitespaceAfter($phpcsFile, $i);
continue;
}
FixerHelper::removeWhitespaceBefore($phpcsFile, $i);
$phpcsFile->fixer->addContentBefore($i, $phpcsFile->eolChar . $innerConditionIndentation);
}
if (!$conditionEndsOnNewLine) {
FixerHelper::removeWhitespaceAfter($phpcsFile, $conditionEndPointer);
$phpcsFile->fixer->addContent($conditionEndPointer, $phpcsFile->eolChar . $controlStructureIndentation);
}
$phpcsFile->fixer->endChangeset();
}
private function shouldReportError(int $lineLength, int $conditionLinesCount, int $booleanOperatorPointersCount): bool
{
if ($conditionLinesCount === 1) {
return $this->minLineLength === 0 || $lineLength >= $this->minLineLength;
}
return $this->alwaysSplitAllConditionParts
? $conditionLinesCount < $booleanOperatorPointersCount + 1
: false;
}
}