Usando un formato estandarizado hacemos que el código sea más fácil de leer y permite que otros desarrolladores puedan modificar el código fácilmente. Joomla! utiliza las normas de codificación PEAR. Una guía completa de las normas de codificación PEAR está disponible en http://pear.php.net/manual/en/standards.php.
He aquí un desglose de las normas más comunes:
- Sangría cuatro espacios:
{
/ / Espacio de cuatro delante de mí! - Las estructuras de control tienen un espacio entre el nombre y el primer paréntesis:
if (true) { - Utilice llaves, incluso cuando son opcionales.
- Funciones y métodos se llaman utilizando el estándar camelCase con una minúscula como primer carácter.
- Funciones y declaraciones de métodos no tienen ningún espacio entre el nombre y el primer paréntesis. Listas de parámetros no tienen espacios en los extremos. Los parámetros son separados por un espacio: foo($bar0, $bar1, $bar2);
- Función opcional y los parámetros del método deben estar en el final de la lista de parámetros. Los valores de los parámetros opcionales, significada por un signo igual, están separados por espacios:
function foo($bar0, $bar1, $bar2 = '') - Utilizar etiquetas phpDocumentor para comentar el código http://www.phpdoc.org/ .
- Utilice include_once() y require() en lugar de include() y require().
- Use <?php ?> Con preferencia a todos los demás delimitadores de bloque de código PHP.