ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: opt / cpanel / ea-wappspector / vendor / slevomat / coding-standard / SlevomatCodingStandard / Sniffs / Commenting

<?php declare(strict_types = 1);

namespace SlevomatCodingStandard\Sniffs\Commenting;

use PHP_CodeSniffer\Files\File;
use SlevomatCodingStandard\Helpers\DocCommentHelper;
use SlevomatCodingStandard\Helpers\PropertyHelper;
use SlevomatCodingStandard\Helpers\TokenHelper;
use function sprintf;
use const T_VARIABLE;

class RequireOneLinePropertyDocCommentSniff extends AbstractRequireOneLineDocComment
{

public const CODE_MULTI_LINE_PROPERTY_COMMENT = 'MultiLinePropertyComment';

/**
	 * @phpcsSuppress SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingNativeTypeHint
	 * @param int $docCommentStartPointer
	 */
	public function process(File $phpcsFile, $docCommentStartPointer): void
	{
		$propertyPointer = TokenHelper::findNext($phpcsFile, T_VARIABLE, $docCommentStartPointer + 1);
		if ($propertyPointer === null) {
			return;
		}

// Not a property
		if (!PropertyHelper::isProperty($phpcsFile, $propertyPointer)) {
			return;
		}

// Check that doc comment belongs to the found property
		$propertyDocCommentStartPointer = DocCommentHelper::findDocCommentOpenPointer($phpcsFile, $propertyPointer);
		if ($propertyDocCommentStartPointer !== $docCommentStartPointer) {
			return;
		}

// Only validate properties without description
		if (DocCommentHelper::hasDocCommentDescription($phpcsFile, $propertyPointer)) {
			return;
		}

parent::process($phpcsFile, $docCommentStartPointer);
	}

protected function addError(File $phpcsFile, int $docCommentStartPointer): bool
	{
		$error = 'Found multi-line comment for property %s with single line content, use one-line comment instead.';

/** @var int $propertyPointer */
		$propertyPointer = $phpcsFile->findNext(T_VARIABLE, $docCommentStartPointer);

return $phpcsFile->addFixableError(
			sprintf($error, PropertyHelper::getFullyQualifiedName($phpcsFile, $propertyPointer)),
			$docCommentStartPointer,
			self::CODE_MULTI_LINE_PROPERTY_COMMENT,
		);
	}

}

[-] DocCommentSpacingSniff.php [edit]
[-] DisallowCommentAfterCodeSniff.php [edit]
[+] ..
[-] ForbiddenAnnotationsSniff.php [edit]
[-] DisallowOneLinePropertyDocCommentSniff.php [edit]
[-] ForbiddenCommentsSniff.php [edit]
[-] UselessInheritDocCommentSniff.php [edit]
[-] RequireOneLinePropertyDocCommentSniff.php [edit]
[-] DeprecatedAnnotationDeclarationSniff.php [edit]
[-] AbstractRequireOneLineDocComment.php [edit]
[-] UselessFunctionDocCommentSniff.php [edit]
[-] InlineDocCommentDeclarationSniff.php [edit]
[-] RequireOneLineDocCommentSniff.php [edit]
[-] AnnotationNameSniff.php [edit]
[-] EmptyCommentSniff.php [edit]