better wp config

Mejor configuración de WP

¿Quieres empezar a utilizar Better WP-Config lo antes posible ?

• Consulte nuestro Inicio rápido o
• Consulte nuestro tutorial de 7 pasos más detallado.

Características

• No se requieren constantes PHP frágiles
  • Mejor WP-Config define() todas las constantes requeridas por el núcleo de WordPress para usted
  • Se configura con matrices asociadas .php , un archivo .env o un archivo JSON .
  • Las opciones de configuración están organizadas por área, por ejemplo, db , debug , error , salts , etc.
  • La especificación de opciones es coherente; no es necesario saber define() vs. ini_set() , etc.
  • Pero puedes especificar las constantes define() necesarias para cualquier complemento o tema.
• Agnóstico del diseño del directorio
  • Almacene archivos de configuración en CUALQUIER directorio, padre o subdirectorio
  • Utilice los directorios private de servidores web administrados para almacenar la configuración
  • Establezca ABSPATH (por ejemplo, WP core) en raíz web, /wp o cualquier otro subdirectorio
  • Establezca WP_CONTENT_DIR en /wp-content , /app o cualquier otro subdirectorio
• Configuraciones en cascada (como CSS) para un fácil mantenimiento
  • Better WP-Config tiene valores predeterminados para las opciones de configuración comunes de WP y PHP
  • Utilice los valores predeterminados de la plataforma para anular los valores predeterminados de Better WP-Config
  • Utilice los valores predeterminados del proyecto para anular los valores predeterminados de la plataforma, etc.
  • Utilice valores predeterminados del entorno que anulen los valores predeterminados de la plataforma, etc.
  • Utilice secretos para anular los valores predeterminados del entorno, etc.
  • Finalmente, la configuración del servidor web puede anular los secretos, etc.
• Proporciona soporte multientorno de primera clase
  • Defina entornos ilimitados: local , test , stage , prod , etc.
  • Asigne entornos con nombre a dominios HTTP_HOST mediante expresión regular
  • Configuración de control de versiones para todos los entornos (excepto secrets )
  • Implemente sin necesidad de cambios de compilación en index.php o wp-config.php
• Manejo opcional de secretos.
  • Excluir de la configuración controlada por versión
  • Cargar desde $_ENV , $_SERVER o getenv()
• Soporte opcional para:
  • Configuraciones personalizadas para servidores web administrados (si es un servidor web, ¡hable con nosotros!)
  • phpdotenv
  • Ubicación del archivo de configuración personalizado; fuera de la raíz web o en directorios private
  • Trivial para implementar multiinquilino
• Descubribilidad
  • Vea todas las opciones y sus valores con wp_config()->print_config();

¡Muéstrame el código!

(Nota: lo siguiente no será cierto hasta que completemos este problema. Hasta entonces, consulte nuestro inicio rápido)

1. Simplemente cree un archivo llamado /wp-content/config/config.php y agregue la configuración de su sitio usando el formato aquí:

    <?php
   return array(
       'db[name]'         => 'example_db',
       'db[user]'         => 'example_user',
       'db[pass]'         => '1234567890abcdef',
       'db[charset]'      => 'utf8mb4_unicode_ci',
       'db[collate]'      => 'utf8mb4',
       'db[host]'         => 'localhost',
       'db[table_prefix]' => 'wp_',
       'defines'          => array(
           'CONSTANT_REQUIRED_BY_A_PLUGIN' => 'it's value'
       ),
   );
   

2. También necesitarás reemplazar /index.php y /wp-config.php de tu sitio con alternativas muy simples que puedes encontrar aquí y aquí, respectivamente.

¡Y eso es todo lo que se necesita!

Sin embargo, antes de hacer suposiciones erróneas:

¡Puedes elegir tu propio directorio!

Better WP-Config puede cargar archivos de configuración desde ../config , /private/config o donde quiera.

¡Puedes usar archivos phpdotenv y .env!

Si eres fanático de separar la configuración y el código, puedes configurar tu file_format en 'env' .

Y puede manejar (¿casi?) cualquier nivel de complejidad.

Puede parecer simple, lo cual fue intencionado para facilitar el comienzo, pero Better WP-Config fue diseñado para manejar requisitos de configuración altamente complejos. Una vez que comience y encuentre casos de uso más complejos, como múltiples entornos e implementación automatizada, verá cuán flexible y poderoso es realmente Better WP-Config.

¿¡¿Pero por qué?!?

Quizás se pregunte qué problema está intentando resolver Better WP-Config. Quizás se pregunte: "¿Por qué necesitamos una mejor solución de configuración de WordPress?" Bueno, necesitamos uno porque hemos descubierto que demasiados casos de uso más allá de lo trivial exigen una mejor solución de configuración. Sigue leyendo:

1. No hay soporte estandarizado para el flujo de trabajo profesional

WordPress es un gran CMS, pero ignora las necesidades de los desarrolladores de WordPress que desean utilizar un flujo de trabajo más profesional, como en entornos test / stage / live . La configuración predeterminada de WordPress fue diseñada para administrar la configuración de un entorno; Si desea administrar más, debe implementar su propia solución de configuración multientorno.

2. Ubicaciones limitadas donde puedes almacenar la configuración.

WordPress le permite almacenar la configuración en wp-config.php en la raíz web, o en un nivel de directorio superior. Aunque puede almacenar su configuración en otro archivo y luego require() en wp-config.php (que es lo que hace Better WP-Config ), crear una solución personalizada significa que también necesitará documentarla y mantenerla, suponiendo que Quiero depender de ello en el futuro.

Y si se toma la molestia de desarrollar y documentar una solución como Better WP-Config, básicamente habrá invertido tiempo (¿y dinero?) en duplicar lo que podría haber usado sin ningún esfuerzo de desarrollo y documentación.

3. Las soluciones de configuración del host administrado son incompatibles

Para colmo de males, cada host administrado de WordPress, como Pantheon y WPEngine, implementa sus propias soluciones de configuración arbitrariamente incompatibles para respaldar su propia oferta de WordPress administrado.

Así es como varios servidores web administrados por WordPress lo manejan y/o lo limitan con wp-config.php .

• Panteón
• WPEmotor

Si está familiarizado con cómo otros sitios web administrados de WordPress manejan wp-config.php considere enviar una solicitud de extracción con documentación sobre cómo manejan su wp-config.php para ayudarnos a nosotros y a otros.

4. Constantes define() inmutables e inflexibles de PHP

Cualquiera que haya trabajado con WordPress sabe cómo configurar las credenciales de la base de datos de WordPress a través de las constantes PHP DB_HOST , DB_NAME , DB_USER y DB_PASSWORD . Esto parece simple y fácil cuando comienzas a trabajar con WordPress, pero con el tiempo te das cuenta de que hace que la configuración sea muy inflexible porque no puedes conectar en cascada las configuraciones desde los valores predeterminados de WordPress, los valores predeterminados de tu proyecto, hasta los detalles específicos de tu entorno y, finalmente, hasta la configuración de tu servidor web.

Better WPConfig no elimina el uso de constantes inmutables, sino que espera hasta que toda la configuración en cascada se fusione antes de define() estas constantes. (Pero este podría ser un primer paso para erradicar el uso de las constantes define() d de PHP de WordPress. Es una idea, porque las constantes inmutables de PHP hacen que las pruebas automatizadas de la funcionalidad de WordPress sean mucho más difíciles de lo necesario).

5. Opciones de configuración difíciles de descubrir

Desafortunadamente, no existe una forma sencilla de encontrar todas las opciones disponibles para el núcleo de WordPress, ya que están implícitas en el código base de WordPress y en varias ubicaciones documentadas en línea. Mejor WP-Config (principalmente) resuelve este problema con "wp_config()->print_config() , análogo a phpinfo()

6. Muchas opciones de configuración no tienen valores predeterminados.

Muchas opciones de configuración no tienen valores predeterminados, como la configuración de la base de datos que aumenta el aprendizaje necesario para el desarrollo local. Better WP-Config proporciona opciones predeterminadas para todas las opciones "conocidas" .

7. Es difícil controlar la versión de la configuración de múltiples entornos

Por sí solo, podría crear un conjunto de convenciones viables para poder controlar la versión de su configuración para todos los diferentes entornos que necesita su proyecto (nosotros lo hicimos), pero luego se da cuenta de que cada proveedor de alojamiento web lo maneja de manera diferente y lo intenta como puede. , siente que es imposible encontrar una solución consistente que su equipo pueda usar y que funcione con los diferentes servidores web que usted y sus clientes han elegido.

Para comprender mejor por qué esto es difícil, asegúrese de leer acerca de cómo Pantheon y WPEngine manejan sus archivos wp-config.php , respectivamente.

8. La implementación es más difícil de lo necesario

Por último, los problemas relacionados con el flujo de trabajo profesional y los casos de uso de control de versiones exacerbados por las elecciones incompatibles realizadas por los servidores web administrados de WordPress simplemente debido a la falta de estandarización de wp-config.php simplemente hacen que la implementación sea más difícil de lo necesario. Esto se aplica ya sea que esté utilizando la carga SFTP, la implementación de Git como Pantheon o la implementación a través de un proveedor de integración continua como CircleCI.

Pero hay una mejor manera

¡La buena noticia es que Better WP-Config resuelve (casi) todos estos problemas hoy! Comience .

Mejores objetivos a largo plazo de WP-Config

Estamos muy contentos con lo bien que funciona Better WP-Config . Sin embargo, las cosas podrían ser:

1. Genial si las bifurcaciones ClassicPress y CalmPress adoptaran Better WP-Config para la configuración,

2. Aún mejor si los servidores web administrados por WordPress estandarizaran Better WP-Config para sus servicios, o

3. Lo mejor de todo sería que WordPress usara Better WP-Config para nuevas instalaciones y, al mismo tiempo, mantuviera el soporte continuo para los sitios existentes que ya usan wp-config.php como lo ha hecho durante años.

Licencia

GPLv2