3

この関数のコメントの最適な書き方は、$dataパラメーターの型の動作に基づいてわずかに異なります。

/**
 * Appends data
 *
 * @param mixed - data array
 * @param value
 * @return self
 */
public function addData($data, $value = '')
{
    if(is_array($data)){
        $this->data = array_merge($this->data, $data);
    } else {
        if($value != ''){
            $this->data[$data] = $value;
        } else {
            $this->data[] = $data;
        }
    }
    return $this;
}

例：

$this->addData($my_array);
$this->addData('my_var', $my_var);
$this->addData($my_var);

アップデート：

/**
 * Appends data
 *
 * @param array|string - This can be either an array to be merged
 *                       OR a value to be added to than array
 *                       OR a key if the $value param is set.
 * @param string - If set the first $data parma will be used as the key.
 * @return object
 */
4

1 に答える 1

2

@param の後には、渡す変数の型を指定する必要があります。複数の型が考えられる場合は、次のように | で区切ることができます。

 /**
 * Appends data
 *
 * @param array|string
 * @param string
 * @return object
 */

タイプ、変数名、および説明を含む、より詳細な例を次に示します。

 /**
 * Appends data
 *
 * @param array|string $parameterOne This is used for...
 * @param string $parameterTwo Optional because...
 * @return object
 */

これは、PHPDoc Web サイト ( http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.param.pkg.html ) の構文です。

@param datatype1|datatype2 $paramname description
于 2013-07-03T15:14:34.460 に答える