Guia de estilo para php

2. Organización de los archivos

2.1. Archivos fuente

Cada clase debe estar en un solo archivo, y un archivo no puede contener más de una clase. Si bien, en un archivo, junto con su clase se pueden definir los elementos relacionados, p.e. las excepciones que puede lanzar.

2.2. Árbol de directorios

Se utilizará el siguiente árbol :

/ Carpeta raiz: Aquí irán los archivos .php alos que accede el usuario directamente, interfaz, etc.
clases: Una carpeta conteniendo exclusivamente las clases usadas en el proyecto .
includes: Todos los archivos que sean llamados por otros .php en forma de módulos o de librerías de funciones.
db: En caso de tener la posibilidad de usar varias bases de datos, aquí colocaremos los .php que manejen esas características multicapa para cadasistema de datos soportado.

3. Indentación

3.1. Longitud de línea

No se mantendrá, siempre que sea posible, la longitud de la línea más allá de los 80 caracteres.

3.2. Dividir líneas

Siempre que sea necesario dividir una línea en dos, se utilizarán las siguientes convenciones:

* Si hay una lista de elemnentos separados por comas, se dividirá tras una coma.
* Si se trata de unaexpresión, se dividirá tras uno de los operadores.
* Preferentemente, una expresión se dividirá en niveles superiores, antes que en inferiores.
* La línea dividida se alineará con el nivel dentro del que se ha producido la división.

3.3. Espaciados de indentación

Para indentar se utilizarán tabuladores, los cuales pueden usarse con muchos editores para representarse condistintas cantidades de espacios y, sobretodo, se convierten en una pulsación por indentación.

4. Declaraciones

4.1. Número de declaraciones por línea

Por definición, nunca se utilizará una misma línea para más de una definición, la cual cosa facilita los comentarios relativos al elemento declarado.

4.2. Inicialización

Siempre que sea posible las variables seinicializarán en la misma línea de declaración.

4.3. Declaración de clases e interfaces

Para definir las clases e interfaces, se seguirán las siguientes reglas:

No se usará ningún espacio entre el nombre de un método y el paréntesis de abertura de la lista de parámetros. La llave de abertura que contiene el código se escribe sola en la línea siguiente a la definición del prototipo.Igualmente, la llave de cierre correspondiente se escribe sola en la última línea.

5. Sentencias

5.1. Sentencias simples

Cada línea contendrá no más de una sentencia, aunque una sentencia puede estar en más de una línea.

5.2. Sentencias de retorno

La sentencia return no utiliza paréntesis.

5.3. Sentencia de selección básica (if/if...else/if...else if...else)

Las llaves de inicio yde cierre de un bloque de código van en líneas independientes. Ejemplo:

if (algo)
{
for (iteracion)
{
//código
}
}
while (condición)
{
funcion();
}

5.4. Sentencias de bucle for

De forma similar a las sentencias de selección, la llave de abertura de y la de cierre irán en una línea independiente.

5.5. Sentencias de buclewhile o do while

De modo idéntico al for, pero en el caso del do while, el while se colocará en la misma línea que la última llave.

5.6. Sentencias de selección múltiple (switch)

Respecto a lo que concierne a las llaves, se colocarán como en el resto de casos. Respecto al código y la línea break, éstas irán con una indentación más que la línea case correspondiente,que irá con una indentación más que la línea de switch.

6. Espacios en blanco

6.1.Líneas en blanco

Se pueden utilizar líneas en blanco para separar grupos de líneas que tengan cierta relación lógica.
Dos líneas en blanco seguidas se usan para:

* Separar secciones de código en un archivo.
* Separar definiciones de clases, interfaces, etcétera, dentro de un archivo....