
📅 Publicado el 14 de noviembre, 2026 · Por Equipo RedServicio
Saber instalar Composer en hosting es de esas cosas que separan al desarrollador que sufre de uno que trabaja tranquilo. Si alguna vez has descargado librerías a mano, copiado carpetas de un proyecto viejo a uno nuevo (con la suerte que eso tiene) o te has liado con las versiones, esto te va a interesar. Aquí va la guía, paso a paso y con los comandos que necesitas, para tenerlo funcionando en tu servidor en cuestión de minutos. Da igual si es un hosting compartido, un VPS o un dedicado.
¿Qué es Composer y por qué lo necesitas en tu proyecto PHP?
Composer es el gestor de dependencias estándar de PHP. Instala, actualiza y resuelve las librerías que usa tu proyecto, y se encarga de que las versiones entre sí cuadren sin que tengas que pensar en ello. ¿Necesitas enviar correos con PHPMailer? ¿Procesar imágenes con Intervention Image? ¿Trabajar con Laravel o Symfony? Un solo comando y todo se descarga.
¿Qué ganas con usarlo? Algunas cosas bastante concretas:
- Reproducibilidad: el archivo composer.lock asegura que tu proyecto use exactamente las mismas versiones de librerías en desarrollo y en producción. Sin sorpresas.
- Autoloading: genera un cargador automático de clases. Se acabó incluir archivos con require uno por uno.
- Actualizaciones seguras: con composer update mantienes las dependencias al día de forma controlada, no a ciegas.
- Ecosistema enorme: acceso directo a Packagist, el repositorio oficial, con cientos de miles de paquetes PHP listos para usar.
Dicho de otro modo: si tu proyecto PHP moderno no usa Composer, estás perdiendo tiempo y asumiendo riesgos de seguridad y mantenimiento que no hacen falta.
Requisitos previos para instalar Composer en tu hosting
Antes de meterse en faena, conviene revisar unos puntos:
1. Acceso SSH
Necesitas poder conectarte al servidor por SSH. En la mayoría de hostings los datos de conexión (host, puerto, usuario) están en el panel de control o en el email de bienvenida. La conexión sería algo así:
ssh [email protected] -p 22
2. Versión de PHP adecuada
Composer pide PHP 5.3.2 o superior. Dicho esto, para proyectos actuales yo no bajaría de PHP 8.1. Compruébalo con:
php -v
3. Extensiones PHP necesarias
Verifica que están activas las extensiones phar, mbstring y json (suelen venir habilitadas de serie):
php -m | grep -E «phar|mbstring|json»
4. Permisos de escritura
Necesitas permisos para crear archivos en tu directorio home (por ejemplo, /home/usuario). En hosting compartido es lo habitual, aunque no está de más confirmarlo con tu proveedor.
Con esto cubierto, ya puedes instalar.
Cómo instalar Composer en hosting paso a paso (con comandos SSH)
Vamos al grano. Conéctate por SSH y sigue los pasos en orden; no conviene saltarse ninguno.
Paso 1: Descargar el instalador oficial
Desde tu directorio home, ejecuta:
cd ~
php -r «copy(‘https://getcomposer.org/installer’, ‘composer-setup.php’);»
Paso 2: Verificar la integridad del instalador
Por seguridad, comprueba el hash SHA-384 del archivo y compáralo con el publicado en la web oficial de Composer. Si coincide, continúa. Si no, repite el paso 1. Mejor perder un minuto que instalar algo corrupto.
Paso 3: Ejecutar la instalación
Instala Composer de forma local (lo recomendable en hosting compartido) para no necesitar permisos de root:
php composer-setup.php –install-dir=~/.local/bin –filename=composer
Paso 4: Eliminar el instalador
php -r «unlink(‘composer-setup.php’);»
Paso 5: Comprobar que funciona
~/.local/bin/composer –version
Si ves la versión instalada en pantalla, ya lo tienes: Composer operativo en tu hosting. Para usarlo sin escribir la ruta completa cada vez, añade ~/.local/bin a tu variable PATH editando el archivo .bashrc. En la segunda parte de esta guía veremos cómo usar Composer para instalar tus primeras dependencias y montar proyectos con Laravel.
Instalar y gestionar dependencias con composer.json
Composer ya funciona en tu hosting. Bien. Ahora toca lo de verdad: gestionar las dependencias de tus proyectos. Todo proyecto que use Composer se apoya en un archivo llamado composer.json, que actúa como el manifiesto del proyecto: ahí se declara qué librerías necesitas, con qué versiones y desde qué repositorios.
Este archivo puedes escribirlo a mano o dejar que Composer lo genere. Para empezar un proyecto nuevo, lo más rápido suele ser el comando init:
- composer init: lanza un asistente interactivo que te pide el nombre del proyecto, la descripción, las dependencias iniciales y la versión mínima de PHP requerida.
- composer require vendor/paquete: instala una dependencia y la añade al composer.json sin que tengas que tocar nada. Por ejemplo, composer require monolog/monolog instala la popular librería de logs.
- composer install: instala todas las dependencias declaradas en el archivo y genera la carpeta vendor junto con el archivo composer.lock.
Hablemos del composer.lock, porque aquí es donde se comete mucha gente equivocaciones. Este archivo fija las versiones exactas instaladas y garantiza que tu entorno de producción replique lo que probaste en desarrollo. La consecuencia práctica: en producción debes usar siempre composer install, no composer update. Este último queda reservado para cuando quieras actualizar dependencias de forma controlada, sabiendo lo que haces.
Consejo práctico: si tu proyecto usa Laravel, puedes crearlo directamente con composer create-project laravel/laravel mi-proyecto. Composer descarga el framework y todas sus dependencias en un solo paso. En los planes de hosting de RedServicio este proceso funciona sin fricciones gracias a la compatibilidad con SSH y versiones modernas de PHP.
Hay otro comando que acabas usando más de lo que crees: composer dump-autoload, que regenera los archivos de autocarga cada vez que añades clases propias. Y un aviso que conviene grabarse: la carpeta vendor no se sube al repositorio Git. Lo correcto es versionar composer.json y composer.lock, y ejecutar composer install en el servidor tras cada despliegue.
Solución de problemas comunes al usar Composer en hosting compartido
¿Todo va a ir bien siempre? No siempre. En hosting compartido hay obstáculos que aparecen con cierta frecuencia. Estos son los más habituales y cómo salir de ellos:
Error de memoria agotada (memory exhausted)
Si Composer se detiene con el mensaje «Allowed memory size exhausted», sube el límite de memoria solo para esa ejecución:
- Con la variable de entorno: COMPOSER_MEMORY_LIMIT=-1 composer install, que elimina el límite para ese proceso.
- O bien: php -d memory_limit=512M /usr/local/bin/composer install.
Versión de PHP incorrecta en la línea de comandos
Esto pasa muchísimo. La versión de PHP del CLI suele diferir de la del módulo web. Compruébalo con php -v y, si necesitas otra versión, invoca el binario concreto: por ejemplo, php8.2 /usr/local/bin/composer install. Instalar dependencias con una versión distinta a la que sirve tu web puede provocar errores de compatibilidad en producción que luego cuesta horas rastrear.
Timeouts durante la descarga de paquetes
En servidores con conexiones lentas o con restricciones, Composer puede agotar el tiempo de espera. Usa composer install –prefer-dist para descargar archivos zip en lugar de clonar repositorios; es notablemente más rápido. También puedes ajustar el timeout de proceso: composer config process-timeout 600.
Problemas de permisos
¿Errores de escritura en la carpeta vendor o en la caché? Verifica que los archivos pertenezcan a tu usuario y que los directorios del proyecto tengan permisos 755. Y no, no asignes 777 por comodidad. Es un riesgo de seguridad innecesario.
Si tras estos ajustes el problema persiste, tienes el soporte técnico 24/7 de RedServicio: el equipo puede revisar la configuración de PHP y los límites de tu cuenta directamente en el servidor.
Conclusiones: optimiza tus proyectos PHP con Composer
Instalar Composer en hosting es, francamente, un paso imprescindible para profesionalizar la gestión de tus proyectos PHP. Como hemos visto en esta guía, el proceso se reduce a conectar por SSH, descargar el instalador oficial, verificarlo y colocar el binario en un directorio accesible. A partir de ahí, comandos como composer require e composer install te permiten incorporar librerías de calidad, mantener versiones consistentes entre desarrollo y producción, y desplegar con cierta tranquilidad.
Quédate con las buenas prácticas esenciales: versionar composer.json y composer.lock, nunca subir la carpeta vendor, usar composer update con criterio y tocar los límites de memoria solo cuando haga falta. Con esta base, frameworks como Laravel o Symfony quedan a un solo comando de distancia.
Eso sí, para aprovechar Composer sin fricciones necesitas un hosting con acceso SSH, versiones actualizadas de PHP y un soporte técnico que responda cuando lo necesites. En RedServicio encontrarás planes pensados para desarrolladores, con instalación de Composer facilitada y asistencia 24/7. Empieza a gestionar tus dependencias como un profesional y lleva tus proyectos PHP donde merecen estar.
Equipo RedServicio
Artículos escritos y revisados por nuestro equipo técnico especializado en hosting e infraestructura web en España.
¿Listo para un hosting de verdad?
Servidores en España · Soporte 24/7 en español · Migración gratuita
Ver Planes desde 3,95€/mes →