Buscar..
Definir el estilo de código para un proyecto.
PhpStorm ofrece configuraciones predeterminadas para el estilo de código para una gran cantidad de idiomas basados en las mejores prácticas y estándares comunes. Pero puede personalizar el estilo de cada idioma en una base por proyecto dentro de la Configuración de PhpStorm> Editor > Estilo de código .
Esquemas
Los esquemas son colecciones de pautas de estilo de código y configuraciones. Puede seleccionar un esquema para un proyecto y se aplicará instantáneamente. También hay un esquema de proyecto que solo está disponible mientras tienes un proyecto abierto. El esquema del proyecto no guarda las pautas en la configuración general del usuario, sino en la configuración propia del proyecto.
Si hace clic en el botón Administrar , puede agregar un nuevo esquema para configurar rápidamente un nuevo conjunto de pautas de estilo de código. El cuadro Administrar también se puede usar para exportar o importar esquemas, lo cual es muy útil si desea compartir esquemas con sus amigos o colegas.
Cambiar el estilo para un idioma específico.
Para cambiar la configuración del estilo de código para un idioma específico, simplemente haga clic en el idioma disponible en la barra lateral. A continuación, se le presentará una página de configuración que es diferente para cada idioma.
Por ejemplo, el lenguaje PHP tendrá configuraciones para pestañas y espacios, llaves o documentos PHP.
Si desea saber qué significa cada configuración diferente, puede consultarlos en la documentación oficial.
Código de estilo de documentación para PhpStorm 2016 y hasta
Imponer un estilo de código específico para un proyecto entre varios miembros del equipo
Actualmente, no existe un método de botón de un solo clic para aplicar realmente las pautas de estilo de código en un equipo, pero hay dos métodos para asegurarse de que un cierto estilo de código se aplique a su producto.
Importar esquemas de estilo de código PhpStorm
La primera y más sencilla solución es configurar un esquema de estilo de código en su propia instancia de PhpStorm, exportar el esquema a un disco portátil o unidad de red e importar el esquema en todas las máquinas de desarrollo.
De esta manera, un desarrollador puede usar fácilmente los métodos abreviados de teclado Cmd + Shift + L (MacOS) o Ctl + Alt + L (Windows / Linux) para formatear automáticamente el código fuente completo.
Puede encontrar información más detallada sobre esto en la siguiente documentación:
Reformateo del código fuente en PhpStorm 2016 y versiones posteriores
Contras
Desafortunadamente, no hay forma de verificar si un desarrollador realmente aplicó el cambio de formato del código. Tendrías que confiar en las promesas de los desarrolladores de que ellos se encargarán del cambio de formato.
Comprobaciones automatizadas de formato de código con un servidor CI
Una forma muy estricta de controlar el formato del código fuente es implementar un servidor de integración continuo como Jenkins que pueda verificar si el código fuente coincide con un estilo de código predefinido.
Asumamos que un desarrollador trabajó en una nueva función en su propia rama de desarrollo y desea enviar sus cambios al repositorio principal. Primero, inserta los cambios en su propia sucursal, donde el servidor CI comprobará la nueva característica. Si la verificación falla porque el código no tiene el formato correcto, se notificará al desarrollador para que pueda corregir los problemas.
Hay varias formas de configurar la calidad del código y las verificaciones de formato con todos los diferentes servidores de integración, por lo que debe explicarse cómo configurar un servidor con verificaciones en las etiquetas correspondientes.
Establezca estilos de código a partir de un estándar predefinido como PSR-2
PhpStorm ya se envía con una gran cantidad de esquemas de lenguaje predefinidos que se basan en pautas y estándares de estilo de código comunes como PSR-2 . Hay un tipo de característica oculta en las páginas de configuración de estilo de código donde puede importar estos estándares y establecerlos como su configuración actual. Para hacerlo, simplemente elija su idioma de codificación en el panel izquierdo. Luego hay un pequeño enlace en la parte superior derecha llamado Conjunto de ...
Al hacer clic en este enlace, PhpStorm le presentará una pequeña ventana emergente donde podrá elegir entre los estándares predefinidos en la pestaña Estilo predefinido .
