Question

说我有以下类存根：

class Gentleman {

    /** @var string */
    protected $guestsName;

    /**
     * @param string $name The name of our esteemed guest
     */
    public function __construct($name) {
        $this->guestsName = $name;
    }

    public function beCourteous() {
        echo 'Salutations, dear ' . $this->guestsName;
    }

}

beCourteous()方法实际上不接受任何输入，或产生任何返回值。什么是正确的phpDoc块？

public function beCourteous() {
    // No docblock
    echo 'Salutations, dear ' . $this->guestsName;
}

/**
 *
 */
public function beCourteous() {
    // One blank line
    echo 'Salutations, dear ' . $this->guestsName;
}

/**
 */
public function beCourteous() {
    // No blank lines
    echo 'Salutations, dear ' . $this->guestsName;
}

Answer 1

不接受任何参数也不返回值的函数在doc注释中不应该有@param或@return。但是，您可以（并且应该）仍然包含说明

/**
 * Echos a salutation to <code>$this->guestsName</code>
 */
public function beCourteous() {
    echo 'Salutations, dear ' . $this->guestsName;
}

见这里:(相关，不完全是一个骗局） PHPDoc: @return void necessary?

在这里： http://en.wikipedia.org/wiki/PHPDoc

Answer 2

您的选择phpDoc将在每种情况下识别一个函数。但也许你想要返回字符串并在类之外构建你的响应字符串。

phpDoc - 没有参数或返回值

2 个答案: