Estilos de programacion
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 sea mucho más sencilla.
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.Estilo de programación (también llamado estándares de código o convención de código) es un término que describe convenciones para escribir código fuente en ciertos lenguajes de programación.
El estilo de programación es frecuentemente dependiente del lenguaje de programación que se haya elegido para escribir. Por ejemplo el estilo del lenguaje de programación C variará con respecto al dellenguaje BASIC .
Características del estilo
El buen estilo, al tratarse de algo subjetivo, es difícil de categorizar concretamente; con todo, existen un número de características generales. Con el advenimiento de software que da formato al código fuente de forma automática, el foco en cómo éste debe de ser escrito debe evolucionar de forma más amplia a la elección de nombres, lógica y otras técnicas.Desde un punto de vista práctico, el uso de un computador para dar formato al código fuente ahorra tiempo, y es posible forzar el uso de estándares a nivel de una compañía completa sin debates religiosos.
Nombres de variable apropiadas
Una piedra clave para un buen estilo es la elección apropiada de nombres de variable. Variables pobremente nombradas dificultan la lectura del código fuente y sucomprensión.
Estilo de indentación
Estilo de identación en lenguajes de programación que usan llaves para indentar o delimitar bloques lógicos de código, como por ejemplo C, es también un punto clave el buen estilo. Usando un estilo lógico y consistente hace el código de uno más legible. Compárese:
if(horas < 24 && minutos < 60 && segundos < 60){
return true;
}else{
return false;
}o bien:
if(horas < 24 && minutos < 60 && segundos < 60)
{
return true;
}
else
{
return false;
}
con algo como:
if(horas 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" siguiendoel orden alfabético en caso de varios bucles anidados ("i", "j", "k",...).
Los nombres largos de las variables 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 arrayvacío, la sintaxis es la estándar:
$miArray = array();
Para crear un array monodimensional, la sintaxis serí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
);...
Regístrate para leer el documento completo.