?HAMA

Navigation

Breadcrumbs

Create

Edit File Size: 1.89 KB

/opt/cpanel/ea-wappspector/vendor/slevomat/coding-standard/SlevomatCodingStandard/Sniffs/Commenting/RequireOneLinePropertyDocCommentSniff.php

Text Base64

<?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,
		);
	}

}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
AbstractRequireOneLineDocComment.php	3.55 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
AnnotationNameSniff.php	6.93 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
DeprecatedAnnotationDeclarationSniff.php	1.29 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
DisallowCommentAfterCodeSniff.php	4.77 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
DisallowOneLinePropertyDocCommentSniff.php	2.65 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
DocCommentSpacingSniff.php	25.19 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
EmptyCommentSniff.php	6.25 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
ForbiddenAnnotationsSniff.php	3.83 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
ForbiddenCommentsSniff.php	3.63 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
InlineDocCommentDeclarationSniff.php	13.98 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
RequireOneLineDocCommentSniff.php	568 B	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
RequireOneLinePropertyDocCommentSniff.php	1.89 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
UselessFunctionDocCommentSniff.php	3.95 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive
UselessInheritDocCommentSniff.php	3.13 KB	lrw-r--r--	2025-09-13 08:53:30	Edit Download recursive recursive

Directory Contents