Formateador de PHP
Formatee código PHP con un estilo coherente y legible mediante el complemento Prettier PHP, cercano a las convenciones PSR-12. Pegue un archivo que empiece por <?php para obtener espacios normalizados, llaves, matrices y cadenas de métodos; las listas largas de argumentos se ajustan al ancho de impresión. Los errores de sintaxis se muestran con el mensaje del analizador, la línea y la columna, lo que ayuda a los desarrolladores de PHP a limpiar código heredado antes de revisarlo.
Preguntas frecuentes
¿Qué formateador se utiliza?
La herramienta ejecuta Prettier 3 con @prettier/plugin-php 0.26 en el servidor. Su salida sigue un estilo cercano a PSR-12: cuatro espacios por nivel de forma predeterminada, llaves de apertura de clases y funciones en su propia línea y una instrucción por línea.
¿Mi código necesita una etiqueta de apertura <?php?
Sí. El complemento formatea el código dentro de las etiquetas PHP. Todo lo que esté fuera se considera HTML en línea y se conserva tal cual, así que un fragmento sin <?php vuelve sin cambios.
¿Qué versiones de PHP son compatibles?
Se entiende la sintaxis moderna de PHP 8, incluidos atributos, enumeraciones, expresiones match, funciones flecha, argumentos con nombre, promoción de propiedades del constructor y clases de solo lectura. También se formatea código antiguo de PHP 5 y 7.
¿El formateador cambiará lo que hace mi código?
No. Solo cambia la presentación. Puede haber algunas reescrituras puramente estéticas; por ejemplo, una sintaxis array() larga puede convertirse en la sintaxis corta equivalente []. Sin embargo, el comportamiento del código sigue siendo el mismo.
¿Qué ocurre si hay un error de sintaxis?
El formateo se detiene y la herramienta muestra el mensaje del analizador con la línea y la columna, por ejemplo, si falta un paréntesis de cierre. Corrija ese punto y vuelva a formatear.
¿Puedo usar tabulaciones o dos espacios?
Sí. Elija 2 o 4 espacios, o active las tabulaciones. El ancho de impresión, de 40 a 200 caracteres, con 80 de forma predeterminada, determina cuándo se ajustan las llamadas, las matrices y las condiciones.
¿Se conservan los comentarios y los bloques de documentación?
Sí. Los comentarios de línea, los comentarios de bloque y los bloques PHPDoc se mantienen junto al código que describen. Su texto no se reorganiza.
¿Puede formatear plantillas que mezclan HTML y PHP?
Formatea los bloques PHP dentro de esas plantillas y mantiene intacto el contenido HTML entre ellos. Los archivos de plantilla complejos quizá aún requieran algunos retoques manuales.
¿Cuánto código puedo formatear de una vez?
Hasta 1 MB de código por solicitud; el formateo se detiene después de 10 segundos. Esto permite procesar incluso archivos individuales muy grandes.
¿Se conserva mi código en el servidor?
No. El código se formatea en memoria y se le devuelve de inmediato. No se guarda y solo se registran los tamaños de las solicitudes.