Embellecedor de código PHP

Qué significa embellecer aquí

Un embellecedor cambia solo el diseño. El código debe hacer lo mismo antes y después. Esta herramienta aplica una lista corta de reglas de diseño:

• Cada punto y coma termina una línea.
• Cada llave de apertura va en una línea propia, y cada llave de cierre también.
• El código dentro de las llaves se sangra un nivel por cada profundidad de anidamiento.
• Las comas van seguidas de un único espacio.
• Las líneas en blanco del resultado se eliminan.

No añade espacios alrededor de los operadores, no renombra nada y no reordena el código.

Un ejemplo de antes y después

Entrada:

<?php class User{private $name;public function getName(){return $this->name;}}

Resultado con 4 espacios:

<?php class User
{
    private $name;
    public function getName()
    {
        return $this->name;
    }
}

Fíjate en que la etiqueta de apertura se queda en la misma línea que la primera instrucción cuando pegas todo en una línea. Si quieres que vaya separada, ponla en su propia línea en la entrada.

Cuándo conviene usar otra cosa

La herramienta cuenta las llaves y los puntos y coma como caracteres normales. No analiza PHP, así que no puede seguir una guía de estilo de proyecto, ajustar líneas largas ni corregir los espacios alrededor de operadores como = o +. Los comentarios, los heredocs y los bucles for (;;) pueden salir mal, porque un punto y coma dentro de ellos se trata como cualquier otro. Para una base de código completa, usa un corrector configurado en tu editor o en tu pipeline de compilación, y deja esta página para limpiezas puntuales.

Embellecer una función con un bucle

Entrada compacta:

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

Cada llave abre un nivel nuevo, así que el cuerpo del bucle queda dos niveles más adentro y return vuelve a uno. Leído de arriba abajo, ahora se ve que el bucle suma en $sum y que la función lo devuelve después. En la versión de una sola línea eso era difícil de ver.

Elegir 2 o 4 espacios

Cuatro espacios es la anchura habitual en código PHP y la más fácil de escanear. Elige 2 cuando el código está muy anidado o cuando el lugar donde lo pegarás es estrecho, como un mensaje de chat. El ajuste cambia solo la sangría, nunca los saltos de línea.

Comprueba el resultado

El código embellecido es más fácil de revisar, que es justo el objetivo. Léelo una vez para detectar llaves que falten o sobren, porque la herramienta las cuenta sin avisar de los problemas. Si la sangría se desajusta de forma extraña hacia el final, la causa habitual es una llave sin pareja en tu entrada.