Compositor para WordPress, Parte 2

En esta publicación, concluiré lo que comencé a compartir ayer: usar las herramientas y bibliotecas que he compartido junto con Composer para rastrear sus confirmaciones durante el desarrollo antes de que el código llegue al repositorio.

Idealmente, siempre querrá ver algo como esto en su terminal cada vez que confirme su código:

Pero ese no es siempre el caso. Sin embargo, como ocurre con la mayoría de las cosas, cuanto más practique, más se acostumbrará a escribir código que pasará automáticamente los diversos olfateos implementados a través de las diferentes reglas (y sus personalizaciones).

Sin embargo, antes de hacer eso, debe configurar GrumPHP en su repositorio.

Composer para WordPress: olfateo de confirmaciones

Ayer, proporcioné una muestra composer.json , así que hoy veremos un archivo de configuración de GrumPHP de muestra y veremos qué hace cada parte.

Lo importante a tener en cuenta es que, aunque algo de lo que verá no es atípico para un proyecto, puede ajustarlo tanto como desee para cada proyecto que utilice. A veces es posible que desee que esté más enfocado de lo que está ahora; otras veces, es posible que no le importen algunos de los olores que ofrece.

Una configuración inicial

Dicho esto, después de instalar GrumPHP, se creará un grumphp.ymlarchivo casi vacío que estará listo para configurarse. Por ejemplo, esto es lo que deberías ver :

parameters:
    git_dir:. bin_dir: vendor/bin
    tasks:

Tenga en cuenta que no hay nada más que especificar:

• la ubicación del depósito,
• la ubicación de los binarios instalados a través de Composer,
• las tareas a ejecutar.

Tenga en cuenta que siempre he usado ‘.’ para la ubicación de mi repositorio porque nunca lo he instalado dentro del repositorio en el que estoy trabajando.

Lo mismo ocurre con los binarios de Composer. Es decir, después de instalar todo a través de Composer, los dejo en sus ubicaciones iniciales.

Y finalmente, la directiva inicial tasksestá vacía porque todavía no hay nada que ejecutar. Eso es lo que miraré en el siguiente paso.

Configurando GrumPHP

Una vez que haya instalado sus bibliotecas y esté listo para configurar un poco, quizás pueda hacer algo como esto :

parameters:
    git_dir:. bin_dir: vendor/bin
    tasks:
      securitychecker:
      composer:
      jsonlint:
      xmllint:
      yamllint:
      phpstan:
      phplint:
      phpunit:
      phpcs:
      phpcpd:
      phpmnd:
      phpparser:
        visitors:
          no_exit_statements: ~
          never_use_else: ~
          forbidden_function_calls:
            blacklist:
              - "die"
              - "var_dump"
              - "exit"
      phpversion:
        project: '7.0'
       phpmd:
         ruleset: ['phpmd.xml.dist']

No resumiré todo lo anterior (porque no hay mucho que resumir), pero todavía hay algunas cosas que señalar:

• Tenga en cuenta que hay una lista de tareas mucho más larga que la definida en el directorio inicial. Eso es normal y significa que queremos ejecutar esas herramientas usando la configuración predeterminada para cada una de esas herramientas.
• Algunas de las reglas tienen un ~al lado de ellos. Esto depende de la tarea en cuestión, pero esto generalmente significa que queremos usar la configuración predeterminada.
• Hay tareas como phpparseresa que tienen subtareas. Algunos de ellos, como puede ver arriba, usan el comportamiento predeterminado. Otros optan por poner en la lista negra términos como die, var_dump, exity más. Esto significa que, como si la directiva no fuera lo suficientemente clara, haremos que GrumPHP falle si se detecta alguna de estas declaraciones.
• Del mismo modo, eche un vistazo a phpmd. Esto apunta al conjunto de reglas que usaremos cuando busquemos varios líos en el código. En este caso, apunta a un dist archivo, pero puede apuntar a cualquier conjunto personalizado de reglas que haya definido.

Esta es solo una muestra de lo que puedes hacer con GrumPHP. Es decir, puede instalar algunas bibliotecas a través de Composer, instalarlas y luego adaptar GrumPHP para aprovechar la funcionalidad que se proporciona.

Al igual que con otros proyectos similares, recomiendo leer la documentación que existe para las diversas tareas que se integran con GrumPHP.

¿Esto es Composer para WordPress?

Si y no. Composer es un administrador de paquetes de propósito general para proyectos PHP; sin embargo, no parece que lo veamos mucho en el mundo de WordPress. Esto no quiere decir que no se use (lo es), pero simplemente conocer Composer y saber cómo usarlo no es suficiente.

En cambio, creo que es importante saber cómo usar Composer para WordPress para que podamos escribir el código de mayor calidad posible mientras nos aseguramos de cumplir con los estándares de codificación que también hemos optado por emplear. .