Aplicar sangría a código PHP

Cómo se calcula la sangría

La herramienta mantiene un contador de profundidad. Cada llave de apertura suma un nivel y cada llave de cierre resta uno. Cada línea se rellena con el número de espacios elegido multiplicado por la profundidad actual. La sangría siempre usa espacios, nunca tabuladores.

Esta es la misma función con cada ajuste. La entrada era function total($items){$sum=0;foreach($items as $item){$sum+=$item["price"];}return $sum;}.

Con 4 espacios:

function total($items)
{
    $sum=0;
    foreach($items as $item)
    {
        $sum+=$item["price"];
    }
    return $sum;
}

Con 2 espacios:

function total($items)
{
  $sum=0;
  foreach($items as $item)
  {
    $sum+=$item["price"];
  }
  return $sum;
}

2 espacios o 4 espacios

Cuatro espacios es la convención habitual en proyectos PHP y la que piden la mayoría de las guías de estilo. Dos espacios mantiene más estrecho el código muy anidado, lo que ayuda cuando lo pegas en un campo pequeño de ticket o en un mensaje de chat. Usa lo que use tu equipo.

Cosas que conviene saber

• Los tabuladores de la entrada no se conservan, porque el espacio en blanco alrededor de llaves y puntos y coma se reconstruye.
• La sangría depende solo de las llaves. El código que continúa en varias líneas dentro de paréntesis, como un array largo, no recibe más sangría.
• Una llave dentro de un comentario o de un heredoc sigue contando, y eso puede desplazar la profundidad de todo lo que venga después.
• Las llaves desequilibradas no se notifican. Si se acaban las llaves de cierre, la profundidad se queda en cero y las líneas siguientes no reciben sangría.

Cómo arreglar código que ha perdido la sangría

La sangría suele desaparecer cuando el código pasa por un campo de formulario, un correo, una herramienta de chat o un archivo de registro. Pegarlo aquí reconstruye la estructura a partir de las llaves, así que no tienes que realinear cada línea a mano. Esto ayuda sobre todo con las clases, donde los métodos y sus cuerpos están a profundidades distintas, y con las funciones largas que tienen varios bucles y condiciones anidados.

Comprueba el resultado

Tras formatear, revisa el borde izquierdo. Cada llave de cierre debe alinearse con la línea que abrió su bloque. Si la última llave aparece con sangría, o si el código que sigue a un bloque se ha desplazado demasiado, falta o sobra una llave en tu entrada. Corrige eso primero y vuelve a ejecutar la herramienta.