Formatear código PHP

Cómo funciona

El código PHP de un plugin o de un proyecto antiguo suele llegar en una sola línea, o escrito con una costumbre distinta en cada archivo. Pegue el código en el cuadro izquierdo. A la derecha, las llaves de clases y funciones pasan a su propia línea, los bloques if, foreach y while se abren en la misma línea, cada instrucción ocupa su línea y los operadores como =, => y + llevan un espacio a cada lado. Por ejemplo, function sumar($a,$b){return $a+$b;} se convierte en una función de tres líneas con sangría de 4 espacios. Este orden se acerca a PSR-12, el estilo común de la comunidad PHP. Si el código tiene un error de sintaxis, como un punto y coma olvidado o un paréntesis sin cerrar, no se cambia nada: verá la línea y la columna y podrá ir directo a ese punto en su editor. En una plantilla que mezcla HTML y PHP solo cambia el interior de los bloques <?php ... ?>. La línea de resultado indica cuántas líneas quedaron.

Esta herramienta también se busca como formatear php, formatear codigo php, php formatter, php beautifier online, ordenar codigo php, formato psr-12.

¿Qué es PHP?

PHP es un lenguaje de programación que se ejecuta en el servidor web y arma la página antes de enviarla al visitante. WordPress, Laravel y muchas tiendas en línea están escritos en PHP. El código empieza con la etiqueta <?php y el mismo archivo puede tener HTML. PHP ignora los saltos de línea y los espacios de más; por eso el código en una sola línea funciona, pero cuesta leerlo.

¿Qué es PSR-12?

PSR-12 (Extended Coding Style) es la recomendación de estilo del PHP Framework Interop Group y reemplaza al antiguo PSR-2. Pide sangría de 4 espacios, llaves de clases y métodos en su propia línea, las de if y foreach en la misma línea, y líneas de preferencia por debajo de 120 caracteres. El objetivo es que el código de distintas personas se vea igual.

¿Cuál es la diferencia entre formatear y validar PHP?

Formatear cambia cómo se ve el código: sangría, espacios y saltos de línea. Validar (lint) revisa si PHP puede leer el código. Como esta herramienta analiza el código antes de darle formato, también detecta errores de sintaxis y dice dónde están. No encuentra variables sin definir, tipos incorrectos ni errores que solo aparecen al ejecutar; para eso hay que ejecutar el código o usar una herramienta de análisis como PHPStan.

¿Dar formato cambia lo que hace el código?

No. La herramienta primero lee el código con un analizador de PHP y luego escribe las mismas instrucciones con un orden nuevo. Los nombres de variables, las cadenas, los comentarios y el orden de las instrucciones no cambian. Solo cambian los espacios, la sangría y los saltos de línea; PHP los ignora, así que el código se ejecuta igual. Un agregado tampoco cambia el sentido: el cuerpo de un if de una línea escrito sin llaves (if ($x) return 1;) recibe llaves, como pide PSR-12.

Si el código no se puede leer, la herramienta no adivina: se detiene y muestra dónde está el problema. Dar formato a código medio roto podría esconder el error en lugar de señalarlo.

¿Qué es PSR-12 y qué tanto lo sigue esta herramienta?

PSR-12 es la recomendación de estilo publicada por PHP-FIG: sangría de 4 espacios, llaves de clases y métodos en línea nueva, llaves de las estructuras de control en la misma línea, un espacio después de las palabras clave. La mayoría de los paquetes de Laravel, Symfony y Composer siguen un estilo parecido.

Esta página usa el plugin de PHP de Prettier. El resultado es muy cercano a PSR-12, pero no idéntico: corta las líneas largas a los 80 caracteres y acomoda arreglos y listas de argumentos con sus propias reglas. Si su proyecto exige un estilo en la integración continua, use la herramienta del proyecto (PHP_CodeSniffer, PHP-CS-Fixer); esta página sirve para hacer legible el código rápido.

• Leer código ajeno, limpiar un fragmento recibido por correo → esta página
• Estilo obligatorio antes de cada commit → la configuración de PHP-CS-Fixer del proyecto
• 2 espacios solo si su equipo lo acordó; PSR-12 pide 4

Preguntas frecuentes

¿Cómo hago legible código PHP minificado?

Pegue el código en el cuadro izquierdo de esta página. Cada instrucción pasa a su propia línea y los bloques de funciones y clases llevan sangría de 4 espacios. Copie el resultado o descárguelo como archivo .php.

¿Qué pasa si mi código tiene un error?

El código con error de sintaxis no se formatea; en su lugar verá la línea y la columna del error. Casi siempre falta un punto y coma o un paréntesis en la línea anterior.

¿Puedo formatear una plantilla .php que contiene HTML?

Sí. Solo se da formato al interior de los bloques <?php ... ?>; el HTML que hay entre ellos no se toca. Para ordenar también la parte HTML, use por separado la herramienta para formatear HTML.

¿Mi código se envía a un servidor?

No. El formato se aplica por completo en su navegador; el código que pega no sale de esta página y no se guarda en ningún lugar.