1000 FAQ, 500 tutoriales y vídeos explicativos. ¡Aquí sólo hay soluciones!
Cambiar la versión de PHP en CLI
Esta guía explica cómo modificar la versión de PHP utilizada en la línea de comandos (PHP CLI) en un Hosting Web de Infomaniak.
Prólogo
- Esta guía es útil si necesita ajustar temporalmente parámetros para un script específico o para una sesión PHP ejecutada en la línea de comandos (CLI).
- Para modificar la versión general de PHP utilizada por su alojamiento en el servidor web (FPM/Apache) a través del Administrador de Infomaniak, consulte esta otra guía.
Versión predeterminada de PHP en la línea de comandos
Cuando ejecuta el comando php
(generalmente a través de /usr/bin/php
), es la versión predeterminada de PHP configurada en el servidor la que se utiliza. Esta versión puede cambiar con el tiempo según las actualizaciones de la plataforma.
Para conocer la versión exacta actualmente activa en su alojamiento, ejecute:
php -v
Para garantizar la estabilidad de sus scripts, se recomienda utilizar una versión explícita (php7.4
, php8.0
, php8.1
, etc.) o ajustar su variable PATH
para que apunte al directorio de la versión deseada (por ejemplo, /opt/php8.1/bin
).
Modificar la versión de PHP utilizada en CLI
Existen dos archivos principales que se pueden utilizar para configurar la versión de PHP cargada automáticamente en su sesión SSH:
1. Uso de ~/.bashrc
(recomendado)
El archivo .bashrc
es leído por Bash al abrir un shell interactivo (no de inicio de sesión), es decir, en la mayoría de los casos cuando abre una sesión SSH normal o ejecuta comandos a través de herramientas de implementación.
Cree el archivo
~/.bashrc
si no existe, luego ábralo:touch ~/.bashrc nano ~/.bashrc
Agregue la siguiente línea para especificar la versión de PHP deseada (por ejemplo: PHP 8.1):
export PATH="/opt/php8.1/bin:$PATH"
Recargue su entorno:
source ~/.bashrc
Verifique la versión actualmente utilizada:
php -v which php
Debería ver una ruta del tipo
/opt/php8.1/bin/php
.
2. Uso de ~/.profile
(alternativa)
El archivo .profile
solo se lee cuando el shell se inicia en modo de inicio de sesión (por ejemplo, al iniciar sesión por primera vez a través de SSH). Si su entorno no carga .bashrc
automáticamente, puede definir la versión de PHP directamente allí.
Cree el archivo
~/.profile
si no existe, luego ábralo:touch ~/.profile nano ~/.profile
Agregue la siguiente línea:
export PATH="/opt/php8.1/bin:$PATH"
Recargue su entorno:
source ~/.profile
3. Cargar .bashrc
desde otros perfiles
Para garantizar que la configuración se cargue en todos los tipos de sesiones (inicio de sesión y sin inicio de sesión), se recomienda incluir en sus archivos ~/.bash_profile
y ~/.profile
la siguiente línea:
if [ -f ~/.bashrc ]; then . ~/.bashrc; fi
De esta manera, su configuración de PHP definida en .bashrc
siempre se aplicará, independientemente de cómo se abra la sesión SSH.
Ejecutar una versión específica de manera puntual
Si desea lanzar un script con una versión específica de PHP sin modificar su entorno, puede llamar directamente al binario correspondiente:
/opt/php8.1/bin/php mon_script.php
/opt/php8.2/bin/php -v
Después de estos pasos, la versión de PHP seleccionada se cargará automáticamente cada vez que se abra una nueva sesión, y sus scripts CLI se ejecutarán con la versión deseada.