Páginas de error del sitio web 404/403 con PHP Auto-Mailer

() translation by (you can also view the original English article)

Las páginas de error de sitios web son quizás una de las piezas más olvidadas de un sitio web totalmente redondeado. No solo son importantes, sino que también te dan la oportunidad de divertirte un poco. Aunque muchos desarrolladores web confían en los registros del servidor para estar atentos a las visitas en las páginas de error, voy a adoptar un enfoque diferente mediante el uso de un correo electrónico generado por PHP. Además, le daremos un toque especial al diseño, agregaremos navegación básica y un enlace al sitemap del sitio web.

Acerca de las páginas de error

La página de error más común, en la que es más probable que esté familiarizado, es la "página 404 No encontrado". Más personas encuentran este tipo de página de error que cualquier otra. Otros mensajes de error comunes que puede haber encontrado son 500 Error interno del servidor, 400 Solicitud incorrecta o 403 Prohibido. ¿Se pregunta para qué es el número? Simplemente se refiere al código HTTP.

Las páginas de error predeterminadas son bastante aburridas (como puede ver más arriba) y no ofrecen ningún otro propósito a los visitantes, aparte de informarles que ocurrió un error aburrido. Por estos motivos, es una gran idea proporcionar páginas personalizadas para los errores más comunes encontrados. Este tutorial solo cubrirá dos: "404 No encontrado" y "403 Prohibido".

Compruebe si hay soporte de página de error personalizado

Primero, verifique que su proveedor de alojamiento le permita usar sus propias páginas de error. Casi todos lo hacen, y la mayoría de ellos incluso proporcionan un área de configuración dentro de su panel de control para ayudarlo a crear rápidamente las páginas. En este tutorial configuraremos un servidor web Apache (el más común). Esto es más fácil de lo que piensas.

Configurar .htaccess

A continuación, conéctese a su servidor a través de FTP o panel de control y navegue hasta el directorio raíz del documento (generalmente www o public_html) que contiene los archivos de su sitio web. Estaremos buscando el archivo .htaccess. A veces está oculto, así que asegúrese de estar viendo todos los archivos, incluidos los ocultos. Si su servidor no tiene uno, puede crear uno usando cualquier editor de texto. Asegúrese de hacer una copia de seguridad del archivo .htaccess si su servidor ya tiene uno.

Agregue las siguientes líneas a su archivo .htaccess:

1	ErrorDocument 404 /error/404.php
2	ErrorDocument 403 /error/403.php

La primera mitad (ErrorDocument 404) le dice al servidor que vamos a definir la ubicación del documento de error 404. La segunda mitad define la ubicación real del documento de error. En este caso, lo pondremos en el directorio "error" y los llamaremos 404.php y 403.php, respectivamente.

Ahora guarde el archivo .htaccess y cárguelo en el directorio raíz del documento.

Diseñar las páginas de error personalizadas

Es mejor seguir con el mismo diseño que usa su sitio web para no confundir a sus visitantes y arriesgarse a perderlos. También debe incluir elementos útiles, como un mensaje de error cortés, enlaces sugeridos, una función de búsqueda o un enlace a su mapa del sitio. Estas características dependerán del nivel de contenido que proporcione su sitio web y de lo que crea que será más útil.

Como puede ver a continuación, la página 404 No encontrado para Nettuts + ha indicado el error y enfatizó la función de búsqueda al incluirla en el cuerpo debajo del mensaje de error. Puede llevar esto un paso más allá incluyendo una breve lista de enlaces a posibles páginas que podrían alentar al visitante a continuar explorando más el sitio (aunque sea simple y breve), o incluso una imagen cómica (a todos les gusta reírse, ¿no? ). Para sitios web pequeños, puede ser una buena idea incluir un sitemap visible también.

Aquí hay algo que reuní para este tutorial que también puede usar para su sitio web (incluido en la descarga anterior). Es muy simple, por lo que podrá colocar el contenido directamente en la plantilla de su sitio web existente. Como puede ver, intenté incluir un poco de un elemento de humor al tiempo que también indico el error con cortesía e incluyo algunas opciones para ayudar al visitante a encontrar lo que estaba buscando o continuar navegando por el sitio web.

Notará que no especifica el código de error HTTP en el cuerpo de la página. En su lugar, elegí usar solo el código de error en el título de la página. La razón de esto es mantener las cosas tan simples y fáciles de usar como sea posible. A la mayoría de las personas no les importa lo que significa 404 o 403, quieren saber qué está pasando en un lenguaje sencillo. Para las personas que desean el código de error, todavía está disponible a través del título.

Si quieres ver algunos diseños 404 realmente geniales visita:

Auto-Mailer PHP y por qué usaremos la notificación por correo electrónico

Esta es la parte del tutorial en la que algunos gurús de la web pueden discutir. Puede usar los registros de su servidor web para buscar páginas de error y mucho, mucho más. ¿Por qué elijo las notificaciones por correo electrónico?

No quiero iniciar sesión en mi servidor todos los días y revisar toda esa información adicional.
Estoy disponible por correo electrónico casi literalmente todo el día, la forma más rápida de contactarme es mediante correo electrónico (o twitter). Con esto en mente, quiero saber acerca de los errores 404 y 403 bastante rápido para que el correo electrónico sea lo mejor.
Un número cada vez mayor de personas está iniciando sitios web, mientras que la mayoría de esas personas no saben casi nada acerca del alojamiento web, y mucho menos de los registros del servidor. Estas personas solo estarán ejecutando sitios pequeños; así que el correo electrónico es ideal.
Recibir una notificación de inmediato me permite actuar rápidamente si se "recolecta" un sitio web mío (plantillas de ThemeForest), si alguien está intentando acceder a algo restringido repetidamente o si tengo un enlace roto en alguna parte.

Así que con todo lo dicho, vamos a seguir con el código vamos a!

El código

Primero, crearemos un archivo llamado error-mailer.php que se utilizará para recopilar información sobre nuestro visitante y enviar el correo electrónico. Una vez que haya creado el archivo, comenzaremos especificando nuestra configuración de correo electrónico y correo electrónico.

<?php

# The email address to send to
  $to_email = 'YOUR-EMAIL@DOMAIN.com';

# The subject of the email, currently set as 404 Not Found Error or 403 Forbidden Error
	$email_subject = $error_code.' Error';

# The email address you want the error to appear from
	$from_email = 'FROM-EMAIL@DOMAIN.COM';

# Who or where you want the error to appear from
	$from_name = 'YourDomainName.com';

Luego recopilaremos información sobre nuestro visitante, como la dirección IP, el URI solicitado, el agente de usuario, etc. El siguiente código recopilará esa información.

# Gather visitor information
    $ip = getenv ("REMOTE_ADDR");                // IP Address
    $server_name = getenv ("SERVER_NAME");       // Server Name
    $request_uri = getenv ("REQUEST_URI");       // Requested URI
    $http_ref = getenv ("HTTP_REFERER");         // HTTP Referer
    $http_agent = getenv ("HTTP_USER_AGENT");    // User Agent
    $error_date = date("D M j Y g:i:s a T");     // Error Date

Ahora escribiremos el script para enviarnos la información por correo electrónico con los detalles especificados anteriormente.

# Send the email notification
require_once('phpMailer/class.phpmailer.php');
    $mail = new PHPMailer();

    $mail->From = $from_email;
    $mail->FromName = $from_name;
    $mail->Subject = $email_subject;
    $mail->AddAddress($to_email);
    $mail->Body =
    "There was a ".$error_code." error on the ".$server_name." domain".
    "\n\nDetails\n----------------------------------------------------------------------".
    "\nWhen: ".$error_date.
    "\n(Who) IP Address: ".$ip.
    "\n(What) Tried to Access: http://".$server_name.$request_uri.
    "\n(From where) HTTP Referer: ".$http_ref.
    "\n\nUser Agent: ".$http_agent;

    $mail->Send();

?>

Estamos utilizando la clase phpMailer para hacer esto como lo demostró Jeffrey a través del blog ThemeForest para crear un formulario de contacto AJAX agradable. Esta versión de la clase phpMailer es para PHP 5/6, por lo que si su servidor está ejecutando PHP 4, deberá usar la versión correspondiente descargándola aquí.

Páginas de error 404.php y 403.php

Lo último que debemos hacer es personalizar las páginas de error que diseñamos anteriormente al enviar los encabezados adecuados y establecer la variable $ error_code insertando el siguiente código al principio de cada página respectivamente (separados por -------).

<?php 

header("HTTP/1.0 404 Not Found");
$error_code = '404 Not Found';		// Specify the error code
require_once('error-mailer.php');	// Include the error mailer script

?>
-------
<?php 

header("HTTP/1.0 403 Forbidden");
$error_code = '403 Forbidden';		// Specify the error code
require_once('error-mailer.php');	// Include the error mailer script

?>

Lo que estamos haciendo aquí primero es configurar el encabezado HTTP correcto para devolver 404 No encontrado y 403 Prohibido, respectivamente. Cuando los motores de búsqueda aterrizan accidentalmente en esta página, queremos asegurarnos de que saben qué tipo de página es, en lugar de pensar que es una página web normal llamada 404.php o 403.php.

Luego especificamos el código de error que se usará en el script de correo e incluimos el script de correo para que pueda hacer su trabajo. De esta manera, si realizamos un cambio en el script de correo, solo necesitamos editar un archivo en lugar de dos o más (si configura páginas de error personalizadas adicionales).

Conclusión

¡Ahí tienes! Sus propias páginas de error personalizadas que son compatibles con los motores de búsqueda, y le informarán por correo electrónico cuando haya tenido un visitante, así como toda la información que necesitará para solucionar cualquier problema. Algunas últimas cosas a considerar:

Internet Explorer requiere páginas de error que tengan al menos 512 byes de tamaño (si utiliza los archivos de ejemplo, estará bien)
Los sitios web de alto tráfico tienen el potencial de generar MUCHOS correos electrónicos, así que asegúrese de configurar algún tipo de filtro de correo electrónico para estas notificaciones de error para que no inunden su bandeja de entrada. Utilizo Gmail, así que solo tengo una configuración de etiqueta y filtro para estos correos electrónicos.