Cómo configurar VSCode con los PHP Coding Standards de WordPress en Mac

Los PHP Coding Standards de WordPress son los estándares (valga la redundancia) que ha marcado la Comunidad WordPress para unificar la forma en la que escribimos el PHP de nuestros plugins y temas.

De forma muy resumida, son unas reglas a cumplir sobre cómo escribir nuestro código PHP (paréntesis, declaración de variables, identación…).

Puedes revisar toda la documentación y una guía de instalación en el repositorio de GitHub.

No obstante, te voy a explicar cómo lo he hecho yo.

Instalar Composer de forma global

Te recomiendo moverte a un directorio donde poder «manchar», por ejemplo descargas:

cd Downloads

Hacemos la descarga

curl -sS https://getcomposer.org/installer | php

Y ahora hacemos que sea accesible de forma global:

mv composer.phar /usr/local/bin

Añadimos el alias para poder utilizarlo fácil y cómodamente:

alias composer="php /usr/local/bin/composer.phar"

Y ya podemos usar el comando composer:

Figura 1: Captura de pantalla del comando composer ejecutado en terminal

Activar validación PHP en VSCode

Necesitamos saber en qué directorio está PHP, esto podemos hacerlo con which php; habitualmente será /usr/bin/php.

Con esta ruta a mano, nos vamos a VSCode y, en el menú superior, vamos a Code->Preferences->Settings. Una vez aquí, buscamos por «php» y configuramos lo siguiente:

Cuando hayas configurado todo esto, debe aparecer algo así en el settings.json:

{
   "php.validate.run": "onType",
   "php.suggest.basic": true,
   "php.validate.executablePath": "/usr/bin/php",
}

Por supuesto, aparecerán más opciones si tienes alguna configuración extra en VSCode.

Instalar PHP Code Sniffer

La forma más fácil de instalar el PHP Code Sniffer es con brew, asegúrate de tenerlo instalado y actualizado.

Instala el Code Sniffer con este comando:

brew install php-code-sniffer

Ya tenemos instalado el PHP Code Sniffer en nuestro Mac.

Añadir el CodeSniffer de PHP a VSCode

Un CodeSniffer es el software encargado de analizar nuestro código en busca de patrones.

Como vamos a usar los WordPress Coding Standards, nuestro PHP CodeSniffer debe estar configurado con los patrones de WordPress.

CodeSniffers para VSCode hay varios, pero yo estoy utilizando phpcs. basta con instalarlo.

Definiendo los WordPress Coding Standards

Antes de configurar nuestro CodeSniffer, necesitamos definir los Coding Standards que va a utilizar, en nuestro caso los de WordPress.

Necesitamos descargar los WordPress Coding Standards de GitHub.

Llegados a este punto, quizá también te interesen los PHP Compatibility Coding Standards.

Sea como fuere, necesitamos descargarlos en nuestro Mac. Hazlo en una carpeta persistente, es decir, descárgalo en un sitio para no moverlo o tu CodeSniffer no lo encontrará y se romperá. En este ejemplo solamente instalaré el WordPress Coding Standard

cd ~
mkdir CodeSniffer
cd CodeSniffer
git clone https://github.com/WordPress/WordPress-Coding-Standards

En mi caso, lo descargaré en ~/CodeSniffer, así lo tengo localizado.

Listo, ya tenemos descargado el WordPress PHP Coding Standard.

Configurar las rutas del PHP CodeSniffer

Ahora que ya tenemos los WordPress Coding Standard instalados en nuestro equipo, necesitamos decirle al CodeSniffer dónde están para que haga uso de ellos.

Podemos revisar la configuración actual de nuestro PHP Code Sniffer con phpcs –config-show.

¡CUIDADO! Lo siguiente que vamos a hacer sobreescribe la configuración actual de tu PHP Code Sniffer, hazlo bajo tu propia responsabilidad.

Ahora, lo que hacemos es configurar la ruta del PHP Code Sniffer con este comando:

phpcs --config-set installed_paths ~/CodeSniffer/WordPress-Coding-Standards

Recuerda cambiar la ruta ~/CodeSniffer/WordPress-Coding-Standards por la tuya.

¡Listo! Ya puedes disfrutar de tu VSCode con los WordPress Coding Standards.

Si abres cualquier tema o plugin y tiene fallos, el PHP Code Sniffer hará su trabajo y te mostrará «errores» como este:

Figura 2: Ejemplo de error del PHP Code Sniffer con los WordPress Coding Standards

No te preocupes, aunque los muestre como error, no son tal y podrás guardar tus ficheros y ejecutarlos, funcionando correctamente.

A partir de ahora, ya sabes, ¡a programar en base a estándares!

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

*

*

DARÍO BALBONTÍN FERNÁNDEZ es el Responsable del tratamiento de los datos personales del usuario y le informa que estos datos serán tratados de conformidad con lo dispuesto en el Reglamento (UE) 2016/679 de 27 de abril (GDPR) y la Ley Orgánica 3/2018 de 5 de diciembre (LOPDGDD), por lo que se le facilita la siguiente información del tratamiento: Fin del tratamiento: mantener una relación comercial y el envío de comunicaciones sobre nuestros productos y servicios. Criterios de conservación de los datos: se conservarán mientras exista un interés mutuo para mantener el fin del tratamiento y cuando ya no sea necesario para tal fin, se suprimirán con medidas de seguridad adecuadas para garantizar la seudonimización de los datos o la destrucción total de los mismos.Comunicación de los datos: No se comunicarán los datos a terceros, salvo obligación legal. Derechos que asisten al usuario: Derecho a retirar el consentimiento en cualquier momento. Derecho de acceso, rectificación, portabilidad y supresión de sus datos y a la limitación u oposición al su tratamiento. Derecho a presentar una reclamación ante la Autoridad de control (agpd.es) si considera que el tratamiento no se ajusta a la normativa vigente. Datos de contacto para ejercer sus derechos: contacto@dariobf.com.

¡Únete ya a BFLabs GRATIS! Estreno próximamente... Más información