In PHP puoi avere una funzione che accetta un numero infinito di argomenti come
/**
* Do abc...
*
* @since 1.0
* @param mixed $arg1 Arg description
* @return string Results
*/
function abc($arg1 = null){
$args = func_get_args();
// do smth with $args
}
Come dovrei illustrarlo nel mio DocBlock?
esempio di manuale phpdoc.org :
/**
* @param mixed $varname,... unlimited OPTIONAL number of additional variables [...]
*/
You may document parameters listed or any optional paramters that will be parsed by standard PHP functions func_num_args()/get_func_arg(). Recommended name format for parameters listed with func_get_arg() is:
- $paramname if there is only one parameter
- $paramname,... if the number of parameters is unlimited
phpDocumentor will display the optional description unmodified.
Note that the $paramname,... will be shown in the output docs in both the parameter listing AND the function signature. If you are not indicating in the actual code that the parameter is optional (via "$paramname = 'a default value'"), then you should mention in the parameter's description that the parameter is optional.
Leggi altre domande sui tag php documentation documentation-generation