?HAMA

Navigation

Breadcrumbs

/ / opt / cpanel / ea-wappspector / vendor / squizlabs / php_codesniffer / src / Standards / PEAR / Tests / Commenting

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 8.93 KB

/opt/cpanel/ea-wappspector/vendor/squizlabs/php_codesniffer/src/Standards/PEAR/Tests/Commenting/FunctionCommentUnitTest.inc

Text Base64

<?php
class PHP_CodeSniffer_File
{

/**
     * A simple function comment.
     *
     * long desc here
     *
     * @param int $stackPtr   The position in @ @unknown the stack of the token
     *                        that opened the scope
     * @param int $detph    How many scope levels down we are.
     * @param int    $index    The index
     * @return
     * @throws
     */
    private function _functionCall($stackPtr, $depth=1, $index)
    {
        return $stackPtr;

}//end _functionCall()

//
    // Sample function comment
    //
    //
    //
    public function invalidCommentStyle()
    {

}//end invalidCommentStyle()

/**
     *
     *
     * A simple function comment
     *
     *
     * Long description with extra blank line before and after
     *
     *
     * @return void
     */
    public function extraDescriptionNewlines()
    {

}//end extraDescriptionNewlines()

/**
     * A simple function comment
     * @return void
     */
    public function missingNewlinesBeforeTags()
    {

}//end missingNewlinesBeforeTags()

/**
     * Access tag should not be treated as a long description
     *
     * @access public
     * @return void
     */
    public function accessTag()
    {

}//end accessTag()

/**
     * Constructor
     *
     * No return tag
     */
    function PHP_CodeSniffer_File()
    {
        return;
    }

/**
     * Destructor
     *
     * No return tag too
     */
    function _PHP_CodeSniffer_File()
    {
        return;
    }

/**
     * Destructor PHP5
     */
    function __destruct()
    {
        return;
    }

function missingComment()
    {
        return;
    }

/**
     * no return tag
     *
     */
    public function noReturn($one)
    {

}//end noReturn()

/**
     * Param not immediate
     *
     * @return
     * @param   int   $threeSpaces
     * @param int     $superfluous
     * @param missing
     * @param
     */
    public function missingDescription($threeSpaces)
    {

}//end missingDescription()

/**
     * Param not immediate
     *
     * @param int      $one   comment
     * @param int      $two   comment
     * @param string   $three comment
     *
     * @return void
     */
    public function oneSpaceAfterLongestVar($one, $two, $three)
    {

}//end oneSpaceAfterLongestVar()

}//end class

/**
 * A simple function comment
 *
 * @param string &$str The string passed in by reference
 * @param string $foo  The string passed in by reference
 *
 * @return void
 */
function functionOutsideClass(&$str, &$foo)
{
    return;
}//end functionOutsideClass()

function missingCommentOutsideClass()
{
    return;
}//end missingCommentOutsideClass()

?><?php
function tagBeforeComment()
{
    return;
}//end tagBeforeComment()

/**
 * no return tag
 *
 *
 *
 */
function noReturnOutsideClass()
{

}//end noReturnOutsideClass()

/**
 * Missing param comment
 *
 * @param int $one comment
 *
 * @return void
 * @fine  Unknown tag
 */
function missingTwoParamComment($one, $two, $three)
{

}//end missingTwoParamComment()

/**
 *
 */
function emptyFunctionDocComment()
{
}//end emptyFunctionDocComment()

/**
 * Test function.
 *
 * @param string $arg1 An argument
 *
 * @access public
 * @return bool
 */
function myFunction($arg1) {}

/**
 * Test function.
 *
 * @param string $arg1 An argument
 *
 * @access public
 * @return bool
 */

echo $blah;

function myFunction($arg1) {}

/**
 * Test function.
 *
 * @access public
 * @return bool
 * @throws MyException
 * @throws MyException When I feel like it
 */
function myFunction() {}

abstract class MyClass {
    /**
     * An abstract function.
     *
     * @return string[]
     */
    abstract protected function myFunction();
}

/**
 * Creates a map of tokens => line numbers for each token.
 *
 * @param array  $tokens    The array of tokens to process.
 * @param object $tokenizer The tokenizer being used to process this file.
 * @param string $eolChar   The EOL character to use for splitting strings.
 *
 * @return void
 */
function foo(&$tokens, $tokenizer, $eolChar)
{

}//end foo()

/**
 * Gettext.
 *
 */
function _() {
    return $foo;
}

class Baz {
    /**
     * The PHP5 constructor
     *
     * No return tag
     */
    public function __construct() {

}
}

/**
 * Complete a step.
 *
 * @param string $status Status of step to complete.
 * @param array  $array  Array.
 * @param string $note   Optional note.
 *
 * @return void
 */
function completeStep($status, array $array = [Class1::class, 'test'], $note = '') {
    echo 'foo';
}

/**
 * Variadic function.
 *
 * @param string $name1    Comment.
 * @param string ...$name2 Comment.
 *
 * @return void
 */
function myFunction(string $name1, string ...$name2) {
}

/**
 * Variadic function.
 *
 * @param string $name1 Comment.
 * @param string $name2 Comment.
 *
 * @return void
 */
function myFunction(string $name1, string ...$name2) {
}

/**
 * Completely invalid format, but should not cause PHP notices.
 *
 * @param $bar
 *   Comment here.
 * @param ...
 *   Additional arguments here.
 *
 * @return
 *   Return value
 *
 */
function foo($bar) {
}

/**
 * Processes the test.
 *
 * @param PHP_CodeSniffer\Files\File $phpcsFile The PHP_CodeSniffer file where the
 *                                        token occurred.
 * @param int                        $stackPtr The position in the tokens stack
 *                                    where the listening token type
 *                                           was found.
 *
 * @return void
 * @see    register()
 */
function process(File $phpcsFile, $stackPtr)
{

}//end process()

/**
 * Processes the test.
 *
 * @param int $phpcsFile The PHP_CodeSniffer
 *                   file where the
 *                                        token occurred.
 * @param int $stackPtr  The position in the tokens stack
 *                                    where the listening token type
 *                                           was found.
 *
 * @return void
 * @see    register()
 */
function process(File $phpcsFile, $stackPtr)
{

}//end process()

/**
 * @param (Foo&Bar)|null $a Comment.
 * @param string         $b Comment.
 *
 * @return void
 */
public function setTranslator($a, &$b): void
{
    $this->translator = $translator;
}

// phpcs:set PEAR.Commenting.FunctionComment minimumVisibility protected
private function setTranslator2($a, &$b): void
{
    $this->translator = $translator;
}

// phpcs:set PEAR.Commenting.FunctionComment minimumVisibility public
protected function setTranslator3($a, &$b): void
{
    $this->translator = $translator;
}

private function setTranslator4($a, &$b): void
{
    $this->translator = $translator;
}

class Bar {
    /**
     * The PHP5 constructor
     *
     * @return
     */
    public function __construct() {

}
}

// phpcs:set PEAR.Commenting.FunctionComment specialMethods[]
class Bar {
    /**
     * The PHP5 constructor
     */
    public function __construct() {

}
}

// phpcs:set PEAR.Commenting.FunctionComment specialMethods[] ignored
/**
 * Should be ok
 */
public function ignored() {

}

// phpcs:set PEAR.Commenting.FunctionComment specialMethods[] __construct,__destruct

class Something implements JsonSerializable {
    /**
     * Single attribute.
     *
     * @return mixed
     */
    #[ReturnTypeWillChange]
    public function jsonSerialize() {}

/**
     * Multiple attributes.
     *
     * @return Something
     */
    #[AttributeA]
    #[AttributeB]
    public function methodName() {}

/**
     * Blank line between docblock and attribute.
     *
     * @return mixed
     */

#[ReturnTypeWillChange]
    public function blankLineDetectionA() {}

/**
     * Blank line between attribute and function declaration.
     *
     * @return mixed
     */
    #[ReturnTypeWillChange]

public function blankLineDetectionB() {}

/**
     * Blank line between both docblock and attribute and attribute and function declaration.
     *
     * @return mixed
     */

#[ReturnTypeWillChange]

public function blankLineDetectionC() {}
}

class SpacingAfter {
    /**
     * There are multiple blank lines between this comment and the next function.
     *
     * @return void
     */

public function multipleBlankLines() {}

/**
     * There are multiple blank lines, and some "empty" lines with only
     * spaces/tabs between this comment and the next function.
     *
     * @return void
     */

public function multipleLinesSomeEmpty() {}
}

class HandleBlankLinesBetweenDocblockAndDeclarationWithAttributes
{
    /**
     * Blank line between docblock and attribute.
     *
     * @return mixed
     */

#[ReturnTypeWillChange]

AnotherAttribute

]#[AndAThirdAsWell]

public function blankLineDetectionA()
    {

}//end blankLineDetectionA()

/**
     * Blank line between attribute and function declaration.
     *
     * @return mixed
     */
    #[ReturnTypeWillChange]

public function blankLineDetectionB()
    {

}//end blankLineDetectionB()
}//end class

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

Directory Contents

Dirs: 0 × Files: 13

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
ClassCommentUnitTest.inc	2.79 KB	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
ClassCommentUnitTest.php	1.80 KB	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
FileCommentUnitTest.1.inc	1.41 KB	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
FileCommentUnitTest.2.inc	168 B	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
FileCommentUnitTest.3.inc	49 B	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
FileCommentUnitTest.4.inc	114 B	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
FileCommentUnitTest.php	2.37 KB	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
FunctionCommentUnitTest.inc	8.93 KB	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
FunctionCommentUnitTest.inc.fixed	8.85 KB	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
FunctionCommentUnitTest.php	2.47 KB	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
InlineCommentUnitTest.inc	488 B	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
InlineCommentUnitTest.inc.fixed	490 B	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive
InlineCommentUnitTest.php	1.45 KB	lrw-r--r--	2025-11-04 16:30:35	Edit Download recursive recursive