¿Qué es PHP Doc?
Contenido del curso
Erick Estrada Mancilla
Juan Pablo Campuzano Monsalve
Daniel G. Parrilla
Bryan Castano
Luis Humberto Osorio Quiceno
Administrativo Expansión TI
Juan David Rueda Quiroga
Israel Josue Feric Godoy
Rodrigo Andrés Moreno Pertúz
Walter Omar Barrios Vazquez
Julio Cardenas
Jorge Guerrero
Erick Ventura
Ermilo Joel Dorantes Uc
Alejandra Ojeda
Juan Pablo Campuzano Monsalve
Ismael Ramos
Jorge Luis Veliz Berzosa
Eminson Mendoza
Kevin Giovanni Cano Blanco
Hallking Quesada Medina
Alejandro Ivan Mendieta
Resumen 100% real no feik ¿Qué es PHP Doc?
PHPDoc no es mas que un estandar informal que tenemos para documentar cédigo en PHP, de esta forma los editores de cédigo pueden mostrar sugerencias cuando implementemos el codigo que estamos comentando.
Es una adaptacion de Javadoc y, además de ayudar a los editores de código, también puede ser Util para algunos generadores de documentacion como phpDocumentor.
atajo para visual studio:
!Untitled
/*
!Untitled
una vez puesto los comentarios relacionados a los requerimientos de la funcion, al hacer un hover sobre la funcion nos mostrará la leyenda de esa misma documentacion donde sea que usemos esa función
!Untitled
Es una buena práctica documentar tus funciones y clases durante la realizacion del código.
Excelente Resumen, lástima que no pueda ver las imagenes!
Si cuando definís la función adelante de cada parámetro ponés su tipo, aparte de tiparlo fuertemente en el PhpDoc lo pone automáticamente
/** * @param int $n1 * @param int $n2 * @return int */ function suma(int $n1, int $n2): int { return $n1 + $n2; }
Uffff R Genial. \
Gracias.
Un saludo. Con respecto a las buenas practicas de código, creo que hayun cambio ya. Ahora al poner en práctica el Clean Code, dice que, se debe documentar lo menos posible, que si se documenta algo, es porque es demasiado especial, pero, que no debemos tener documentación porque nuestro código debe ser tan limpio,que al leer la función, debemos saber que hace...
Va con clean code y principios SOLID.
concuerdo contigo.
Eso le ayuda mucho a la ide y a copilot entender lo que hacemos
Es una extension de VScode llamada: PHP DocBlocker, sin embargo es muy importante saber que para que funcione exactamente como al profe tienes que escribir el slash y asterisco encima de la funcion. saludos 🧑💻
jejejej llevo leyendo documentación y haciendo eso en todos los lenguajes que he programado algunos aceptan makdown por ejemplo /**
hola soy un <h2>,
*/ muy bueno, existe una extension MINTLIFY que lo hace con un comando mas rapido....
Muy útil la documentación que nos podamos procurar para nuestro programador del futuro y para nuestro trabajo en equipo.
primera vez que utilizo phpdoc:
A mi no me aparece el phpdoc cuando pongo la barra y asteriscos. Alguien sabe porque?
Hola, creo que se le paso por alto a Retax, pero esta extensión de vscode te ayuda con eso.
PHP DocBlocker
Me pasó igual, instalé este: PHP DocBlocker v2.7.0
solo sirve para funciones?? o lo puedo utilizar en otros casos?
Mi aporte:
<?php /** * Esta función retorna la suma de dos números * * @param integer $n1 * @param integer $n2 * @return integer */ function suma(int $n1, int $n2){ return $n1 + $n2; } $resultado = suma(1,2); echo $resultado;
Con las nuevas versiones de PHP 8+ nos podemos ahorrar ese trabajo, especificando los tipos de entrada de las funciones y el tipo de retorno. Usando nombres descriptivos se hace más facil dar entender lo que una función hace.
PHP doc es un estandar informal
Para equipos de desarrollo con lo siguiente puedes agregar el autor y fecha en la que desarrollaste el metodo o la función.
"php-docblocker.functionTemplate": { "message": {}, "extra": {}, "param": {}, "return": {} }, "php-docblocker.extra": [ "@author Ing. Eminson Mendoza email@gmail.com", "@since $CURRENT_DATE/$CURRENT_MONTH/$CURRENT_YEAR $CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND" ],
Buenisima la extención.
en lo particular haga algo similar peor no uso el param int y demás.. y en mi documentalista suele poner un ejemplo de como usar los parámetros.
¿esta bien si lo hago de esta forma?
//Esta función permite crear una carpeta //Recibe un parámetro //Esta funcione es privada, y se utiliza en la función subir_archivos /* * *$nombre - nombre de la carpeta * * ejemplo $nombre = "carpeta" * * Devuelve true * */
pfff, lo vi en el curso de java pero que genial que se tenga en php :o
