Cómo instalar Composer en servidores compartidos

Composer es una herramienta imprescindible para la gestión de dependencias en proyectos PHP. Te permite declarar las bibliotecas que necesita tu proyecto y las administra de manera eficiente, instalándolas o actualizándolas cuando sea necesario. A diferencia de gestores de paquetes como Yum o Apt, Composer gestiona dependencias a nivel de proyecto: las instala en un directorio específico dentro del propio proyecto (por ejemplo, la carpeta vendor), sin afectar a otros proyectos alojados en el servidor.

En esta guía verás, paso a paso, cómo instalar Composer en una cuenta de hosting compartido con cPanel utilizando el acceso SSH.

Requisitos previos

• Acceso SSH habilitado: asegúrate de que tu cuenta de hosting tenga acceso SSH activo. Si no lo tienes habilitado, solicita su activación antes de continuar.
• Cliente SSH instalado: para acceder a tu servidor necesitarás un cliente SSH. Si usas Linux o macOS, puedes utilizar la terminal predeterminada. En Windows, puedes usar herramientas como PuTTY, disponible de forma gratuita.

Fase 1: Conectarse al servidor por SSH

Para conectarte a tu cuenta de hosting mediante SSH:

1. Abre tu cliente SSH (puedes utilizar PuTTY en Windows o la terminal en Linux/macOS).
2. Introduce la siguiente línea de comando en tu terminal:

   ssh username@nombre_servidor -pPORT

   Donde:

   • ssh es el comando para iniciar sesión en el servidor remoto.
   • username es tu nombre de usuario de cPanel.
   • nombre_servidor es el servidor donde está alojada tu cuenta (puedes encontrarlo en tu panel de cPanel).
   • PORT es el número de puerto que debes usar: 21098 para servidores de hosting compartido o 22 para VPS o servidores dedicados.

Configurar la conexión en PuTTY (Windows)

1. Abre PuTTY.
2. Introduce tu dominio o la dirección IP del servidor en el campo Hostname.
3. En el campo Port, ingresa 21098 o 22, dependiendo de tu tipo de servidor.
4. Selecciona SSH como el tipo de conexión.
5. Haz clic en Open para iniciar la sesión.

6. Si recibes la alerta de seguridad de PuTTY, pulsa Sí:

7. Cuando se te solicite, ingresa tu nombre de usuario y contraseña de cPanel (al escribir la contraseña, esta se oculta automáticamente por motivos de seguridad):

Fase 2: Verificar la versión de PHP

Composer requiere la versión PHP 5.5+, por lo que es necesario verificar que tu cuenta tenga configurada una versión compatible. Escribe el comando php -v en PuTTY (o en la Terminal) y obtendrás un resultado similar a este:

Si necesitas cambiar la versión de PHP, inicia sesión en tu cPanel y ve a la sección Software >> Seleccionar Versión PHP. Si tienes dudas sobre este punto, consulta la guía Cómo comprobar la versión y configuración de PHP.

Selecciona la versión de PHP que corresponda:

NOTA: Composer requiere que la directiva allow_url_fopen esté activada. En nuestros servidores compartidos, esta opción está habilitada por defecto para todas las versiones de PHP. Sin embargo, puedes verificar que esté activada siguiendo estos pasos:

1. Accede a cPanel.
2. Dirígete a la sección Software y selecciona Seleccionar Versión de PHP.
3. Haz clic en Opciones de PHP.
4. Asegúrate de que la opción allow_url_fopen esté marcada.

Fase 3: Preparar el directorio y el archivo php.ini

A continuación, navega hasta la carpeta en la que deseas instalar Composer. En nuestro ejemplo, lo instalaremos en public_html:

cd public_html

Ahora tendrás que encontrar o crear el archivo php.ini y asignarle algunos valores. Inicia sesión en cPanel y abre el menú Administrador de archivos:

Ve a la carpeta en la que se instalará Composer y crea un nuevo archivo llamado php.ini utilizando el botón + Archivo:

Abre el archivo haciendo clic con el botón derecho sobre el php.ini recién creado: Archivo >> Editar.

Luego, agrega los siguientes valores al archivo y presiona el botón Guardar cambios:

max_execution_time = 300
max_input_time = 300
memory_limit = 512M
suhosin.executor.include.whitelist = phar
detect_unicode = Off

Fase 4: Instalar Composer

Cuando hayas terminado todos los preparativos, estarás listo para instalar Composer. Abre la ventana de PuTTY donde iniciaste sesión con tu cuenta de cPanel y ejecuta el siguiente comando:

php -r "readfile ('https://getcomposer.org/installer');" | php -c php.ini

Esto ejecutará la instalación de Composer:

Para ejecutar comandos de Composer, usa:

php composer.phar

Solución de problemas

En caso de que recibas la notificación "algunas configuraciones en su máquina hacen que Composer no pueda funcionar correctamente", asegúrate de que la versión de PHP sea 5.5 o superior y de que todos los cambios en el archivo php.ini estén guardados.

Preguntas frecuentes

¿Composer viene preinstalado?

No necesitas que venga preinstalado: siguiendo los pasos de esta guía puedes instalar Composer directamente en el directorio de tu proyecto vía SSH, lo que además te da control sobre la herramienta dentro de tu propia cuenta.

¿Qué versión de PHP necesito?

Composer requiere PHP 5.5 o superior, con la directiva allow_url_fopen activada. Puedes comprobar tu versión con el comando php -v o cambiarla desde cPanel en Software >> Seleccionar Versión PHP.

¿Puedo usar Composer en hosting compartido?

Sí. Solo necesitas una cuenta con acceso SSH habilitado y una versión de PHP compatible. Composer instala las dependencias dentro de la carpeta de tu proyecto, por lo que funciona sin inconvenientes en un plan de hosting compartido.