Asegura la calidad de tus proyectos PHP
Lukas Kahwe, publica en su blog una serie de recomendaciones para asegurar la calidad de tus proyectos PHP. Las comprobaciones mínimas que se deben realizar para la QA (Quality Assurance) de aplicaciones PHP son:
- Crear pruebas unitarias por lo menos de las partes principales de la aplicación (en PHP está disponible PHPUnit y en Symfony está disponible Lime)
- Para las partes más difíciles de examinar con pruebas unitarias, se pueden utilizar herramientas como Selenium (que también la recomienda Symfony) o Badboy.
- La API de la aplicación debe estar lo suficientemente documentada. Herramientas como phpDocumentor o Doxygen automatizan esta tarea.
- Las aplicaciones y sobre todo los frameworks, deberían proporcionar herramientas para depurar las aplicaciones. En este punto Symfony cumple con creces, por los diferentes controladores frontales, la barra de depuración, etc.
- Utilizar herramientas automáticas de revisión de código para evitar ataques CS, XSS o SQL injection.
Comentarios
-
#1
Hola!! alguien me puede explicar brevemente en qué consiste y cómo se usa phpDocumentor???
Gracias -
#2
Hola Senechaux,
Si sabes Java, la forma más fácil de explicar phpDocumentor es la siguiente: "se trata de una copia de JavaDoc para PHP".
Si no has programado con Java, la explicación es "sencilla":
phpDocumentor permite generar de forma automática la documentación del código fuente de una aplicación PHP.
¿Cómo lo hace? Pues extrae los comentarios que se añaden a las clases, métodos y funciones.
Evidentemente no hace magia, por lo que para hacer una buena documentación debes utilizar alguna etiqueta específica para indicar información como el autor del código, los parámetros, etc.
¿Una buena fuente para aprender phpDoc? El mismo código de Symfony, que está perfectamente comentado. Ejemplo de clase sfCache:
/*
sfCache is an abstract class for all cache classes in symfony.
@package symfony
@subpackage cache
@author Fabien Potencier fabien.potencier@symfony...
@author Fabien Marty fab@php..
@version SVN: $Id: sfCache.class.php 3198 2007-01-08 20:36:20Z fabien $
*/
Este artículo ya no permite añadir más comentarios.
¿Por qué? Los artículos cierran sus comentarios automáticamente
unos meses después de su publicación para asegurar que estos sigan
siendo relevantes.
Proyectos Symfony destacados
La plataforma de eCommerce 100% Symfony que rivaliza con Magento y PrestaShop. Ver más
Síguenos en @symfony_es para acceder a las últimas noticias.