Este plugin establece las siguientes constantes de depuración en wp-config.php al activar el plugin y los elimina al desactivarlo. Cualquier error resultará en el lanzamiento de una Excepción PHP. Constantes de depuración en Depuración en WordPress.
Ajustes por defecto:
define( 'WP_DEBUG_LOG', true );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );
@ini_set( ‘display_errors’, 1 ); se establece cuando el plugin está activo. WP_DEBUG se establece como verdadero cuando el plugin se ejecuta por primera vez, después se puede desactivar en los ajustes.
La página de Ajustes permite al usuario configurar lo siguiente.
define( 'WP_DEBUG', true ); // Default on initial plugin installation.
define( 'WP_DEBUG_DISPLAY', false ); // Default when not declared is true.
define( 'WP_DISABLE_FATAL_ERROR_HANDLER', true ); // WordPress 5.2 WSOD Override.
Cuando se desactiva el plugin, se hace todo lo posible para reponer las constantes preexistentes a su estado anterior. Cuando el plugin se activa, se restablecen los ajustes por defecto y cualquier configuración guardada.
Este plugin usa el comando wp-cli/wp-config-transformer para escribir constantes en wp-config.php.
Debug Quick Look de Andrew Norcross se incluye con este plugin para ayudar a leer el archivo debug.log. Si ya tienes este plugin instalado debes eliminarlo cuando WP Debugging no esté activo.
Los plugins Query Monitor y Debug Bar son dependencias opcionales para ayudar a la depuración y la resolución de problemas. El aviso de instalación se repetirá 45 días después de ser desestimado.
Si tienes una ubicación no estándar para tu archivo wp-config.php puedes usar el filtro wp_debugging_config_path para devolver la ruta del archivo para su instalación.
El filtro wp_debugging_add_constants permite al usuario añadir constantes a wp-config.php.
El filtro devuelve un array en el que la clave es el nombre de la constante y el valor es un array de datos que contiene el valor como cadena y un booleano para indicar si se debe pasar el valor sin comillas o no.
$my_constants = [
'my_test_constant' =>
[
'value' => 'abc123',
'raw' => false,
],
'another_test_constant' => [ 'value' => 'true' ],
];
La opción value contiene el valor de la constante como una cadena.
La opción raw significa que en lugar de colocar el valor dentro de la configuración como una cadena, ésta pasará a ser sin comillas. El valor por defecto es true. Establécela como false para valores no booleanos.
Ejemplo:
add_filter(
'wp_debugging_add_constants',
function( $added_constants ) {
$my_constants = [
'my_test_constant' => [
'value' => '124xyz',
'raw' => false,
],
'another_test_constant' => [ 'value' => 'true' ],
];
return array_merge( $added_constants, $my_constants );
},
10,
1
);
Esto creará las siguientes constantes.
define( 'MY_TEST_CONSTANT', '124xyz' );
define( 'ANOTHER_TEST_CONSTANT', true );
Desarrollo
PRs are welcome against the develop branch on GitHub.