Uso de estándares de codificación con WordPress
Escribo bastante sobre los estándares de codificación con WordPress y la importancia que creo que tienen para las personas, los equipos y el trabajo con la aplicación principal, que es WordPress en sí.
En el último año más o menos, dejé de trabajar principalmente con los estándares de codificación de WordPress y comencé a usar las recomendaciones estándar de PHP para la codificación.
Tenga en cuenta que no dije que abandoné los estándares de codificación de WordPress ni que elevé las recomendaciones de PSR por encima de ellos, pero tengo razones para usar cada uno. Y para cualquiera que trabaje con proyectos basados en WordPress, creo que es importante reconocer cuándo es apropiado usar cada uno.
Y ese es el propósito de este post.
Estándares de codificación con WordPress
Antes de discutir cada una de las variantes en los estándares de codificación, quiero dejar en claro que nada de lo que digo debe tomarse como una regla estricta y rápida. En el mejor de los casos, tal vez una regla general. En el peor de los casos, completamente ignorado, ¿verdad? 🙃
Sin embargo, hablando en serio, a pesar de los esfuerzos habituales y los puntos de discusión de defender un estándar sobre el otro, sostengo la opinión de que hay un momento y un lugar para usar cada uno.
Al momento de escribir esto, estoy trabajando en dos proyectos y uno usando los Estándares de Codificación de WordPress; los otros están usando el PSR.
Aquí está la cosa:
La decisión no se trata de qué conjunto de estándares de codificación son los mejores. A la gente le gusta discutir este punto, y eso está bien para ellos. Yo no. En cambio, trato de adoptar la postura de ser lo más pragmático posible.
Y para hacer eso, trato de usar un conjunto de preguntas para tomar decisiones sobre qué estándares de codificación usar.
Un filtro para la toma de decisiones
Antes incluso de hablar sobre los dos tipos de estándares, es importante reconocer que hay un proceso de pensamiento, un filtro a través del cual, puede ejecutar todas sus ideas para tomar la decisión más informada posible según su proyecto.
Hice lo mejor que pude para capturar el orden en el que considero qué conjunto de estándares usar y los comparto aquí. Sin ningún orden en particular.
- WordPress. ¿Estás escribiendo algo que necesitará ser compatible con tantas instalaciones de WordPress (a pesar de las versiones de PHP)?
- WordPress ¿Está trabajando en el mantenimiento de un proyecto que se escribió para una versión anterior de PHP o que se escribió usando los estándares de codificación de WordPress?
- WordPress _ ¿Has heredado un proyecto o estás manteniendo un proyecto que no tiene el presupuesto para refactorizar el código base?
- WordPress o PSR. ¿Está trabajando con un equipo que usa esto como su conjunto principal de estándares de codificación?
- PSR. ¿Puedes convencer a tu cliente de usar PHP7+?
- PSR. ¿Tiene control total sobre el entorno en el que se implementa el proyecto?
- PSR. ¿Tiene un proyecto que se escribió anteriormente en una versión anterior de PHP que tiene el presupuesto para un servidor más nuevo y refactorización?
- PSR. ¿Quiere escribir en una base de código que le ayude a llevar sus habilidades de PHP a una era más moderna y al mismo tiempo traer consigo WordPress?
Y finalmente, otra pregunta que haría es esta:
¿Qué estándares de codificación tiene en su sistema? ¿Qué tan fácil es configurar su IDE? Deje tiempo para configurarlo y las respuestas a la guía de preguntas anterior qué conjunto de estándares utiliza.
En última instancia, el objetivo es hacer que sea lo más fácil posible determinar qué estándar usar.
¿Un mensaje final?
Antes de concluir esta serie, quiero proporcionar una lista de recursos adicionales que creo que son útiles para aquellos que trabajan con WordPress de alguna manera.
Tal vez sea un desarrollador experimentado, tal vez solo se esté volviendo estándar o tal vez esté en algún punto intermedio.
Independientemente, hay algo para todos nosotros, y si puedo compartir la mayor cantidad de información posible para ayudarlo a convertirse en un mejor desarrollador independiente de WordPress, entonces estaré logrando una parte del objetivo que me propuse con esta serie en particular. .
Sin embargo, por ahora, piense un poco en el esquema de los estándares de codificación anteriores y vea si no ayuda con la administración de algunos de sus proyectos existentes.
Una nota sobre la programación orientada a objetos
Tenga en cuenta también que a principios de esta semana, comencé, o reanudé, dependiendo de cuánto tiempo haya estado leyendo este material, en la programación orientada a objetos en WordPress. Entonces, si también está interesado en saltar a eso, entonces puede comenzar con esta publicación (ya que también hace referencia a algunas de las otras).