Depurar errores en aplicaciones o ficheros PHP

Una pantalla en blanco o un error 500 indican que la petición no terminó como se esperaba, pero no identifican por sí solos la capa ni el componente que falló. El origen puede estar en la aplicación, PHP, una directiva de .htaccess, el servidor web o un límite de recursos.

Reproduce la URL u operación exacta y anota la hora. Empieza por la fuente más acotada que pueda contener ese evento:

1. Si conoces la aplicación, consulta primero su registro o modo de depuración, manteniendo desactivada la salida de errores en pantalla. Para WordPress, utiliza Depurar errores en WordPress.
2. Si el registro de la aplicación no contiene el evento, o se trata de un fichero PHP independiente, consulta el registro de PHP de la versión efectiva. Si no está activo, habilita temporalmente log_errors desde cPanel.
3. Si la petición no aparece en PHP, se modificó .htaccess o el error se produce antes de ejecutar la aplicación, consulta el registro de errores del sitio o del servidor web.

Que un registro no contenga la petición no demuestra que la aplicación haya sobrescrito la configuración. Comprueba antes la versión efectiva de PHP, el alcance de la configuración, el destino y permisos de error_log, y si la petición llegó a esa capa.

Solo atribuye el fallo a un componente cuando el registro o una reproducción controlada lo relacione con el mensaje concreto. Hasta entonces, cualquier explicación es una hipótesis.

Cerrar el diagnóstico

Guarda el primer error y su traza, el cambio que lo corrigió y el resultado de repetir la misma operación. Una línea de una biblioteca puede ser donde se detectó un dato inválido, no donde se creó; evita modificar ese archivo sin seguir la traza.

Retira la depuración temporal, confirma que los detalles no se muestran al visitante y conserva los registros solo durante el tiempo necesario. Para pedir ayuda, facilita un ejemplo mínimo con datos ficticios y las versiones de PHP y aplicación, sin adjuntar configuraciones completas que contengan contraseñas.