Preguntas etiquetadas con phpdoc

417
¿Sugerencias de tipo PHPDoc para una matriz de objetos?

Entonces, en PHPDoc se puede especificar @vararriba de la declaración de la variable miembro para insinuar su tipo. Luego un IDE, por ej. PHPEd, sabrá con qué tipo de objeto está trabajando y podrá proporcionar una idea del código para esa variable. <?php class Test { /** @var SomeObj */...

115
Comentarios de funciones PHP

Solo una pregunta rápida: he visto que algunas funciones de PHP están comentadas en la parte superior, usando un formato que desconozco: /** * * Convert an object to an array * * @param object $object The object to convert * @return array * */ Mi IDE me da una selección desplegable para...

85
Sugerencias de tipo de variable en Netbeans (PHP)

Solo tengo curiosidad por saber si hay una forma en netbeans de dar pistas de tipo para variables regulares, de modo que intellisense lo capte. Sé que puede hacerlo para propiedades de clase, parámetros de función, tipos de retorno, etc. pero no puedo averiguar cómo hacerlo para variables...

81
PHPDoc: ¿@return void es necesario?

¿Es realmente necesario hacer algo como esto? /** * ... * * @return void */ Tengo bastantes métodos que no tienen un valor de retorno, y parece realmente redundante poner algo como esto en el comentario. ¿Se consideraría de mala educación dejarlo fuera?