En los últimos días algunas contribuciones han inyectado código no estándar dentro de la rama principal de Joomla!. Este es un buen momento para recordar cómo configurar PHP CodeSniffer para asegurarnos de que nuestro código cumple los estándares.
Joomla! tiene un repositorio en Github con sus estándares de programación. El archivo README contiene toda la información necesaria para configurar phpcs:
1Instalar CodeSniffer
La versión de CodeSniffer integrada en Ubuntu normalmente es demasiado vieja para funcionar con los estándares de Joomla! que requieren la versión 1.3 o posterior. Así que mejor instalaremos el último CodeSniffer a través de PEAR:
sudo pear install PHP_CodeSniffer
2Instalar estándares de programación de Joomla!
Podemos clonar directamente el repositorio con los estándares en la carpeta de CodeSniffer con el comando:
sudo git clone http://github.com/joomla/coding-standards.git `pear config-get php_dir`/PHP/CodeSniffer/Standards/Joomla
Eso es todo. Ya podemos validar nuestro código con:
phpcs --standard=Joomla index.php
Ese comando de ejemplo validará manualmente el archivo index.php del directorio actual y mostrará los errores encontrados.
Pero la mejor forma de usar phpcs es integrándolo en nuestro IDE.
La integración con Eclipse, Netbeans y PHPStorm está documentada en:
http://docs.joomla.org/Joomla_CodeSniffer
La integración con Sublime Text 2 puedes encontrarla en nuestro artículo:
Sublime Text 2 for Joomla! development