Guia de Estilo de Programacion

Introducción
El estilo de programación son las series de convenciones seguidas al desarrollar código fuente en un determinado lenguaje de programación.
Esta guía describe las convenciones usadas para el desarrollo en PHP aunque se pueden extender perfectamente a otros lenguajes con sintaxis similar.
El estilo de programación descrito en esta guía es sólo una recomendación, aunque se instafervientemente a su utilización para garantizar que todo el código fuente generado por varias personas tenga un estilo similar con lo que se consigue que las revisiones de código entre los distintos programadores sean mucho más sencillas.

Estilo genérico usado
Dentro de los estilos más genéricos de programación, se usará el estilo BSD KNF (BSD Kernel Normal Form) y se parece mucho al estilo K&R.Términos usados
Camel Case
Es la práctica de escribir frases o palabras compuestas eliminando los espacios y poniendo en mayúscula la primera letra de cada palabra. Siempre nombrar los objetos en singular.
Lower Camel Case
Similar al Camel Case sólo que la primera letra de la primera palabra es también en minúscula. Por ejemplo, la frase "generar datos aleatorios" pasada a lowerCamelCasesería "generarDatosAleatorios".
Upper Camel Case
Similar al Camel Case siendo la primera letra de la primera palabra en mayúscula. Por ejemplo, la frase "generar datos aleatorios" pasada a UpperCamelCase sería "GenerarDatosAleatorios".

Palabras reservadas
Las palabras reservadas del lenguaje así como las construcciones que se asimilan a funciones (array(), list(), etc.) se escribirán todas enminúsculas.

Indentación (sangrado) - Estilo GNU
La indentación o sangrado debe ser hecha mediante tabulaciones y no se deben insertar espacios. El estilo GNU coloca una llave sobre la siguiente linea. Las llaves son indentadas por 2 espacios,y el codigo que contiene indentada por 2 espacios adicionales.

Variables
Las variables usadas en cualquier aplicación deben tener nombres que lasidentifiquen, es decir, nombres como "a", "b" o "c" no se deberían usar sino que deberían tener un nombre coherente con con lo que contienen. En el siguiente ejemplo los nombres de las variables son cortos por lo que no se identifica su significado:
$a = 0, $b = 0, $c = 0;
if($a > 10 && $b > 20 && $c > 30) {
return true;
} else {
return false;
}
Este ejemplo debería ser:
$hora = 0, $minuto =0, $segundo = 0;
if($hora > 10 && $minuto > 20 && $segundo > 30) {
return true;
} else {
return false;
}
Sólo en el caso de que la variable sea lo demasiado genérica para no tener un nombre concreto (por ejemplo el índice de un bucle) ésta se declarará con el nombre de "i" siguiendo el orden alfabético en caso de varios bucles anidados ("i", "j", "k",...).
Los nombres largos de lasvariables se escribirán en lowerCamelCase.

Variables especiales
Existen variables que no son variables de tipo simple sino que son compuestas, por ejemplo, los arrays y las estructuras.
En PHP no existen estructuras ya que gracias a los arrays asociativos no son necesarias.
Para crear un array vacío, la sintaxis es la estándar:
$miArray = array();
Para crear un array monodimensional, la sintaxissería la misma que la anterior:
$miArray = array(1,2,3,4,5);
Para crear un array multidimensional (o asociativo), éste se pondría en líneas separadas e indentadas una tabulación respecto al nombre de la variable que lo contiene de la siguiente forma:
$miArrayMultidimensional = array(
1 => "primero",
2 => "segundo",
3 => "tercero",
4 => "cuarto"
);
En caso de ser un array asociativo,para mejorar la legibilidad, se debería indentar el valor de cada entrada a la misma altura de la siguiente forma:
$miArrayAsociativo = array(
"Barcelona" => 08000,
"Guadalajara" => 19000,
"Leon" => 24000,
"Madrid" => 28000,
"Santa Cruz de Tenerife"=> 38000
);

$miArrayVariado = array(
"primero" => 1,
"segundo" => array(
"hora" => 16,
"minuto" => 58,
"segundo"...