Guía: Cómo instalar Composer localmente en una cuenta cPanel usando SSH

22.01.2025

Guía: Cómo instalar Composer localmente en una cuenta cPanel usando SSH

Composer es una herramienta esencial para gestionar dependencias en proyectos PHP. Si necesitas una versión más actualizada de Composer que la instalada globalmente en tu servidor cPanel, puedes instalarla de manera local en tu cuenta utilizando SSH. A continuación, te explicamos cómo hacerlo paso a paso.

Requisitos previos

  1. Acceso a tu cuenta de cPanel.
  2. Habilitación del acceso SSH. Si no tienes acceso SSH, comunícate con tu proveedor de hosting.
  3. Cliente SSH instalado en tu máquina local (por ejemplo, PuTTY en Windows o la terminal en macOS/Linux) o nuestro recomendado MobaXterm.

 

Paso 1: Acceder a tu cuenta mediante SSH

  1. Conéctate a tu cuenta cPanel usando SSH.

    • En macOS/Linux: Usa el comando:
      ssh tu_usuario@tu_dominio.com
    • En Windows: Usa un cliente como PuTTY o Mobaxterm y proporciona tus credenciales SSH.
  2. Una vez dentro, verifica que estás en tu directorio raíz ejecutando:

    pwd

    El resultado debería ser algo como:

    /home/tu_usuario

Paso 2: Descargar Composer

  1. Descarga el instalador oficial de Composer ejecutando el siguiente comando:

    php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
  2. Verifica la integridad del instalador usando la clave hash oficial. Esto es opcional pero recomendado por motivos de seguridad:

    php -r "if (hash_file('SHA384', 'composer-setup.php') === '55ce33dcaf31b6351dbbcba20f5fdd10c4b9e0c5d4ebf29f51c569b71f3a233fc45b6c241d22e891c2a82e51fc70536f') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

    Nota: Sustituye el hash por el más reciente disponible en la página oficial de Composer.


Paso 3: Instalar Composer localmente

  1. Ejecuta el instalador para instalar Composer localmente en tu directorio:

    php composer-setup.php --install-dir=bin --filename=composer

    Esto instalará Composer en la carpeta bin dentro de tu cuenta cPanel. Si no tienes la carpeta bin, el sistema la creará automáticamente.

  2. Limpia el instalador una vez completada la instalación:

    php -r "unlink('composer-setup.php');"

Paso 4: Configurar el alias para usar Composer

Para que puedas usar Composer desde cualquier lugar de tu cuenta cPanel, configura un alias.

  1. Abre o crea el archivo .bashrc o .bash_profile en tu directorio raíz:

    nano ~/.bashrc

    (Si estás usando bash_profile, cambia el nombre en el comando).

  2. Agrega la siguiente línea al archivo:

    alias composer='/home/tu_usuario/bin/composer'
  3. Guarda los cambios y cierra el editor. En nano, usa CTRL + O, presiona Enter, y luego CTRL + X.

  4. Recarga tu archivo de configuración del shell:

    source ~/.bashrc

Paso 5: Verificar la instalación de Composer

Para asegurarte de que Composer está instalado correctamente y usa la versión local, ejecuta:

composer --version

Deberías ver algo como:

Composer version 2.x.x 202x-xx-xx

Notas importantes

  1. ¿Por qué instalar Composer localmente?
    Instalar Composer de forma local te permite usar la versión más actualizada, ya que el Composer global del servidor puede estar desactualizado debido a las políticas del proveedor de hosting.

  2. Mantenimiento:
    Si deseas actualizar tu instalación local de Composer en el futuro, puedes hacerlo fácilmente ejecutando:

    composer self-update
  3. Evitar conflictos con Composer global:
    Usar un alias para la instalación local garantiza que no interfieras con la versión global de Composer configurada por el servidor.


Ahora tienes Composer instalado localmente en tu cuenta cPanel y puedes disfrutar de la versión más reciente para tus proyectos PHP. Este enfoque es ideal cuando necesitas funcionalidades específicas de versiones más nuevas que no están disponibles globalmente en el servidor. Si tienes dudas o necesitas asistencia, no dudes en contactar al equipo de soporte de Imagina Colombia.

¡Hablemos!