El archivo PHP.ini es un archivo de configuración que contiene los ajustes de PHP de su servidor web. Cada vez que PHP se inicia, su sistema lo buscará y ejecutará para habilitar las reglas de scripting de su sitio.
Aunque viene preconfigurado, es posible que necesite cambiar la configuración predeterminada de PHP para adaptarla a sus necesidades. Por ejemplo, puede modificar el nombre y la duración de la cookie de sesión para habilitar la función de "recordarme" en su sitio.
En este artículo, explicaremos la ubicación del archivo PHP.ini y sus parámetros importantes. También aprenderás cómo editar el archivo para cambiar la configuración de PHP.
¿Qué es PHP.ini?
PHP.ini es un archivo de configuración que contiene los ajustes de PHP de su servidor web.
Le permite controlar las reglas relacionadas con PHP de su sitio, como establecer el límite de tamaño al cargar archivos y ocultar mensajes de error.
Esta ubicación del archivo de configuración de PHP varía según el servidor web. Para cambiar sus ajustes, edite el archivo y cambie el valor de los parámetros a través de un editor de texto.
¿Dónde se encuentra el archivo PHP.ini?
La ubicación del archivo PHP.ini varía según su servidor, la versión de PHP y el sistema operativo. Al ejecutar PHP, el sistema busca el archivo en los siguientes lugares:
1. La ubicación específica del módulo de interfaz de programación de aplicaciones del servidor (SAPI).
2. La variable de entorno de configuración en tiempo de ejecución de PHP (PHPRC).
3. El directorio de trabajo actual, que se puede buscar mediante la función getcwd().
4. El directorio del servidor PHP o web instalado.
En lugar de buscar manualmente sus archivos INI a través de los administradores de archivos de su hosting, los usuarios pueden hacerlo automáticamente.
Entre varios métodos, crear un nuevo archivo PHP dentro del directorio raíz de su dominio es el más fácil. Para este tutorial, le mostraremos cómo hacerlo a través de hPanel:
1. Vaya a hPanel → Hosting → Gestionar.
2. Haga clic en Administrador de archivos.
3. Navegue hasta el directorio raíz de su sitio. En nuestro caso, es /home/usuario/public_html.
4. Seleccione el ícono + Archivo. Ingrese un nombre de archivo con extensión PHP, como phpinfo.php. Luego, haga clic en Crear nuevo archivo.
5. Haga clic derecho en el nuevo archivo → Editar e ingrese el siguiente código:
```php
<?php
phpinfo();
?>
```
6. Haga clic en Guardar cambios.
7. Ingrese su dominio.tld/phpinfo.php en su navegador web y presione Enter.
8. Busque el archivo de configuración cargado. La ruta del PHP.ini debería verse así:
Ruta del archivo PHP.ini en la salida de información de PHP
Este método también funciona en cPanel para localizar el archivo PHP.ini de un servidor virtual privado (VPS). Alternativamente, conecte mediante SSH y ejecute el siguiente comando:
```bash
php -i | grep 'Configuration File'
```
Su cliente SSH mostrará el directorio, que es usr/local/lib para la mayoría de los servidores web. Además de consultar la ubicación, puede mover y editar el archivo PHP.ini con el cliente SSH.
Parámetros importantes del archivo PHP.ini
En esta sección, explicaremos los parámetros más importantes en el archivo PHP.ini, incluyendo sus valores y propósitos. Estos parámetros también se conocen como directivas.
display_errors
Determina si los mensajes de error de PHP se muestran a los usuarios durante la ejecución del script, utilizando los valores on y off. Por razones de seguridad, solo debe utilizar esta directiva durante el desarrollo de su sitio.
error_reporting
Establece qué mensaje de error se muestra a los usuarios cuando display_errors está habilitado. El parámetro error_reporting toma varias constantes para mostrar diferentes errores.
Puede usar varias constantes y excluir errores específicos. Por ejemplo, para mostrar todos los errores excepto la advertencia de obsolescencia, utilice lo siguiente:
```php
E_ALL & ~E_DEPRECATED
```
error_log
Especifica el archivo donde PHP registrará errores para solucionar problemas. Antes de habilitarlo, asegúrese de que los usuarios del servidor web tengan permiso para escribir en el archivo.
file_uploads
Establece si las cargas de archivos HTTP están habilitadas o no. El valor on permitirá a los usuarios cargar archivos en su sitio, mientras que off lo deshabilita.
upload_max_filesize
Este parámetro determina el tamaño máximo de archivo cargado que PHP permite en su sitio. Dado que el valor predeterminado es de 2 MB, puede aumentar el límite máximo de tamaño de carga para permitir a los usuarios cargar archivos grandes.
Lee más sobre este tema en nuestro tutorial sobre cómo solucionar el problema de upload_max_filesize en caso de error.
post_max_size
El tamaño máximo de datos POST que PHP puede recopilar de los formularios HTML en su sitio. El valor debe ser mayor que el tamaño máximo de archivo, ya que se maneja con la función POST.
allow_url_fopen
Permite escribir un script PHP para acceder a archivos remotos desde otro servidor. Está desactivado de forma predeterminada, ya que habilitarlo podría exponer su servidor a un ataque de inyección de código.
allow_url_include
Esta directiva tiene una función similar a allow_url_open, pero utiliza la función include. Para habilitarlo, allow_url_open debe estar configurado en on.
Esta directiva establece el nombre de la sesión actual utilizado en cookies y URL. Puede cambiar el valor predeterminado PHPSESSID a cualquier nombre descriptivo con caracteres alfanuméricos.
session.auto_start
Elige si una sesión PHP se inicia automáticamente o a solicitud cuando los usuarios acceden a su sitio. Si establece el valor en 0, la sesión se iniciará manualmente mediante el script session_start.
session.cookie_lifetime
Especifica la duración de la cookie de sesión en los navegadores de los visitantes de su sitio. Por defecto, el valor se establece en 0 segundos, lo que significa que su sitio borra los datos de la sesión de los visitantes después de cerrar sus navegadores.
memory_limit
Establece la cantidad máxima de RAM que un script PHP puede usar. Tenga cuidado al aumentar el límite de memoria, ya que configuraciones incorrectas pueden provocar sitios lentos o caídas del servidor.
max_execution_time
Determina el tiempo máximo de ejecución de un script. Puede cambiar el tiempo máximo de ejecución predetermin
ado de 30 segundos a cualquier valor, pero establecerlo demasiado alto podría causar problemas de rendimiento.
Lee más en nuestra guía sobre cómo solucionar el error fatal: max_execution_time exceeded si obtiene este código de error.
max_input_time
Establece cuánto tiempo puede un script analizar datos recopilados de formularios HTML en su sitio mediante un método POST o GET. Cuanto más datos recopile su sitio, mayor debería ser el valor de max_input_time.
upload_temp_dir
Especifica el directorio temporal para almacenar archivos cargados. Todos los usuarios deben poder escribir en el directorio especificado, o PHP utilizará el predeterminado del sistema.
realpath_cache_ttl
Establece la duración para que su sistema almacene en caché la información de realpath. Recomendamos aumentar el valor para sistemas con archivos que cambian raramente.
arg_separator.output
Utilice esta directiva de manejo de datos para separar argumentos en las URL generadas por PHP. Su valor predeterminado es un ampersand (&).
arg_separator.output
Establezca el separador que PHP utiliza para analizar las URL de entrada en variables. Por defecto, es un ampersand, pero puede cambiarlo a otros símbolos como punto y coma.
Cómo editar el archivo PHP.ini
Antes de editar el archivo PHP.ini, verifique la configuración de PHP de su servidor utilizando phpinfo.php. Si está configurado como un módulo de Apache, cambie la configuración de PHP mediante su archivo .htaccess.
¡Importante! Haga una copia de seguridad de su archivo PHP.ini antes de editarlo. Esto le permite restaurar rápidamente el archivo, ya que configuraciones incorrectas pueden provocar problemas de rendimiento o tiempo de inactividad.
Para PHP CGI, edite directamente el archivo INI utilizando el Editor INI MultiPHP de cPanel para configurar los ajustes.
Si está utilizando hPanel, simplemente descargue y edite el archivo con un editor de texto.
Para los usuarios de cPanel, aquí están los pasos:
1. Acceda a su cPanel.
2. Vaya a la sección de Software → Editor INI MultiPHP.
3. Haga clic en la pestaña Modo básico. Para una personalización más profunda, seleccione el Modo de editor en su lugar.
4. Desde el menú desplegable, seleccione el directorio de inicio o la ruta del dominio. Esto configurará su archivo PHP.ini específico del dominio.
5. Cambie la configuración para cada directiva de PHP y haga clic en Aplicar para guardar los cambios.
6. Si su servidor no admite la herramienta del editor, use el selector de PHP en su lugar.
Alternativamente, descargue el archivo PHP.ini y cambie las directivas de configuración con un editor de texto.
Menú de configuración del Selector de PHP en cPanel
Para los usuarios de VPS, configure los ajustes de PHP a través de un cliente SSH. Asegúrese de haber instalado el editor de texto Nano y ejecute este comando:
```bash
nano usr/local/lib/php.ini
```
Cambie el directorio con la ruta de su archivo PHP.ini en su VPS.
Conclusión
PHP.ini es un archivo de configuración que almacena los ajustes de PHP de su servidor web. Puede editarlo para cambiar las reglas relacionadas con PHP de su sitio, como restringir acciones o limitar el tamaño de los datos cargados.
Dado que su ubicación varía, cree un archivo de información de PHP en el directorio raíz de su dominio y cárguelo en su navegador para encontrar rápidamente PHP.ini. En la información de PHP, la ubicación está en la sección del archivo de configuración cargado.
El archivo PHP.ini contiene varios parámetros para configurar el manejo de errores, las cargas de archivos, la configuración de sesiones y otras reglas. Para cambiar la configuración, edite los valores de los parámetros respectivos.
Los usuarios de hPanel de HolyHosting pueden simplemente descargar el archivo y cambiar los parámetros en un editor de texto. Si tiene más preguntas, deje un comentario a continuación.
