Qué es el archivo phpinfo y cómo se crea

La combinación de Linux, Apache, base de datos MySQL y el intérprete PHP —conocida por la sigla LAMP— se considera desde hace aproximadamente dos décadas el estándar para el hosting web de un sitio en Internet. Sin embargo, debido a la complejidad del sistema, con frecuencia surgen problemas o errores especialmente durante la configuración, lo que requiere un diagnóstico detallado. Una de las herramientas más importantes para acotar las causas es la función phpinfo integrada en el intérprete PHP. Su uso aporta numerosas ventajas prácticas, por lo que se ha consolidado como la primera herramienta para comprobar las características de un servidor web y su compatibilidad con determinados requisitos.

Contenido:
¿Cuál es la función de phpinfo?
¿Qué muestra la función phpinfo?
¿Cómo funciona phpinfo como herramienta?
¿Cómo puede utilizarse phpinfo como ayuda?
¿Qué problemas pueden surgir al usar phpinfo?

¿Cuál es la función de phpinfo?

phpinfo es un método integrado en PHP que recupera todos los datos relevantes del intérprete y de su entorno desde diferentes fuentes y los presenta de forma clara en una única página web. Concretamente, esto se realiza mediante la sencilla instrucción PHP phpinfo(). Como indican los paréntesis finales, se trata de una función que se invoca sin parámetros adicionales y que puede insertarse en cualquier lugar del código fuente. Su utilidad práctica en un servidor en producción es, en principio, limitada —a menos que un administrador quiera proporcionar a sus visitantes detalles sobre la configuración del servidor, lo cual no es recomendable desde el punto de vista de la seguridad—.

La tarea más importante de phpinfo consiste —salvo algunas aplicaciones como el análisis automático del entorno— en la depuración y la optimización de un hosting web y, en concreto, del entorno PHP. Para permitir un análisis exhaustivo, la función recurre a distintos programas y herramientas del sistema operativo y recopila todos los datos relevantes sobre un servidor web. A partir de estos datos, la función genera a continuación una página web ordenada en tablas, en la que un administrador encuentra toda la información esencial sin tener que invocar y examinar manualmente los distintos componentes servidor de bases de datos y servidor web, así como la instalación de PHP, incluidas las diversas archivos de configuración.

¿Qué muestra la función phpinfpo?

Aunque la función phpinfo se implementó originalmente para la configuración y la verificación del propio PHP, debido a la multitud de parámetros que captura y evalúa ofrece el enfoque más importante para analizar también el entorno —es decir, la combinación de Apache o NGINX, las bases de datos disponibles y PHP. La presentación se realiza de forma clara en varias tablas, cada una asignada a un tema específico. La salida de phpinfo incluye, entre otros, en el orden que se indica a continuación:

• Versión actual de PHP
• Datos generales del servidor, como la versión del kernel y los directorios importantes
• Configuración global y local del servidor web
• Cabeceras HTTP detalladas al acceder a una página
• Compatibilidad con la compresión de datos mediante Bzip2 y con la extensión calendar
• Configuración local y global de los parámetros de PHP
• Detalles sobre diversas utilidades como cURL, exif o hash
• Configuración local y global de los parámetros de MySQL
• Compatibilidad y versión de openssl para el cifrado
• Integración de XML para el formateo de datos
• Información sobre Zend OPcache para la optimización del rendimiento
• Datos importantes sobre el entorno, como el usuario en uso y los directorios
• Variables utilizadas por PHP y los valores almacenados
• Créditos, desarrolladores responsables y tipo de licencia Open Source

Todos estos datos pueden ser relevantes en determinadas circunstancias, porque PHP utiliza numerosos programas externos y aplicaciones del sistema para poder desempeñar sus funciones como corresponde. Entre ellos se encuentran, por ejemplo, Client for URLS (cURL) para la descarga de datos y un programa FTP, con cuya ayuda establece conexiones para la subida de archivos grandes. Aunque esta información no es en general secreta, por ello se recomienda, como regla general, no dejar phpinfo accesible públicamente de forma permanente, ya que puede ser utilizado como herramienta para buscar vulnerabilidades —por ejemplo mediante el uso de una versión concreta de un programa—.

¿Cómo funciona phpinfo como herramienta?

phpinfo es una función incorporada que cualquier script PHP puede invocar como un comando en cualquier lugar de su código. Para usarla, basta con introducir el comando phpinfo() en un script nuevo o existente. En su variante más simple y habitual, el script tiene el siguiente aspecto:

(signo menor)?php
phpinfo();
?(signo mayor)

La primera y la última línea indican al intérprete que entre los dos signos hay código PHP que debe ejecutarse línea por línea. En medio aparece el comando phpinfo con paréntesis vacíos, ya que no es necesario pasar parámetros adicionales para la tarea. El punto y coma en PHP marca simplemente el final de una instrucción y, por tanto, que el comando termina en ese punto. En términos abstractos se trata únicamente de un comando sencillo que, al ejecutarlo, genera una página web dinámica que recupera datos de distintas fuentes y los presenta de forma clara y en tablas.

¿Cómo se puede utilizar phpinfo como herramienta?

Un script phpinfo puede ser accedido por el usuario como una página web convencional si se encuentra en una ruta de acceso públicamente disponible dentro del directorio de contenidos. Para su uso práctico existen distintas opciones:

• Crear un nuevo archivo mediante acceso SSH
• Insertar el comando en un script PHP existente
• Crear el archivo localmente y subirlo mediante un programa FTP
• Crear el archivo localmente y subirlo mediante la interfaz web del panel de control

El método más eficaz es el de la utilización de SSH, ya que permite un acceso directo al servidor y la creación directa del script. Para este método solo se requieren unos pocos pasos:

• 1. Establecer la conexión con el servidor mediante un cliente SSH como SSH (Linux) o PuTTY (Windows)
• 2. Con cd ruta/a/tu/sitio acceder al directorio raíz público del sitio
• 3. Iniciar un editor de texto sencillo con nano phpinfo.php
• 4. Copiar el código PHP en el campo de texto
• 5. Cerrar el editor con Ctrl + X y confirmar el guardado con j o y

Como alternativa, con el editor nano se pueden abrir scripts ya existentes, por ejemplo el archivo index.php ubicado en el directorio raíz, para insertar el comando phpinfo() al inicio del código. Sin embargo, este procedimiento no es recomendable, ya que por motivos de seguridad no se deberían modificar de forma permanente archivos existentes, la salida se mostrará dentro de la página ya existente y, por último, pueden surgir complicaciones con el contenido adicional del propio script index.php requerido.

La segunda variante requiere crear el script PHP de forma local en tu equipo y realizar un posterior upload, por ejemplo mediante un programa FTP o una interfaz web adecuada. Hay que tener en cuenta que Microsoft Windows y Linux usan diferentes señales de control para el final de línea de un archivo de texto. Por este motivo, para la creación se debe usar un editor compatible, como por ejemplo el gratuito Notepad, y cambiar el formato a Unix/Linux. A continuación, solo hay que subir el script mediante el FTP o la interfaz a un directorio público.

El nombre del script, al igual que el directorio elegido, no importa y puede elegirse libremente. Por ejemplo, es posible ocultar el script como fix_abc.php en el subdirectorio Pictures. La llamada se realiza simplemente introduciendo la dirección utilizada en el formato Dominio.TLD/directorio/nombre.php en cualquier navegador, por ejemplo en el caso mencionado arriba:

https://Example.com/Pictures/fix_abc.php

El servidor reconocerá entonces el script y lo pasará al intérprete de PHP.

¿Qué problemas pueden surgir al usar phpinfo?

Los únicos requisitos para utilizar phpinfo son un servidor web configurado y en funcionamiento con su entorno, así como la posibilidad de un acceso directo desde una página externa. Si aparece un código de estado Error HTTP 404 - No encontrado o 403 Prohibido, significa que no se encuentra en la ubicación elegida o que no tiene permisos para el acceso. En el primer caso, las causas más frecuentes son que el directorio no está dentro del sitio web o que el nombre está mal escrito. Debe tenerse en cuenta que, a diferencia de Microsoft Windows, Linux distingue entre mayúsculas y minúsculas en los nombres de archivos. Por tanto, la escritura de directorios y nombres debe coincidir exactamente con la forma indicada. Un código de error 403 significa, en cambio, que el archivo existe pero el servidor web no tiene permisos suficientes para leerlo. Se puede permitir un acceso sin restricciones fácilmente con el comando SSH chmod 777 name.php o ajustando los permisos en un programa FTP. Si se produce un error de servidor con un código como Error HTTP 500 - Error interno del servidor o 502 Bad Gateway, la causa es una configuración gravemente errónea de PHP o del servidor web. Esta debe corregirse antes de usar phpinfo o de publicar la página. Por motivos de seguridad, se recomienda encarecidamente eliminar la función tras su uso, por ejemplo con el comando SSH rm name.php.

Foto: Lawrence Monk en Pixabay