Instalar Composer en Hosting: Guía Completa de Dependencias PHP

📅 Publicado el 31 de agosto, 2026 · Por Equipo RedServicio

Qué es Composer y por qué necesitas instalar Composer en hosting

Si gestionas una web hecha en PHP, tarde o temprano te vas a topar con esto: necesitas instalar Composer en hosting. Y no hay vuelta atrás. Composer es el gestor de dependencias estándar de PHP; sirve para declarar qué librerías necesita tu proyecto (Guzzle, PHPMailer, Laravel, Symfony…) y descargar las versiones correctas junto con sus propias dependencias, todo automáticamente. Sin él, mantener un proyecto PHP al día se convierte en un trabajo manual, propenso a errores y muy difícil de escalar.

¿La buena noticia? Casi cualquier hosting decente permite usar Composer, incluso en planes compartidos. Bastan dos cosas: acceso SSH y una versión de PHP razonablemente moderna (7.4 como mínimo, aunque yo recomendaría no bajar de 8.1). En RedServicio, por ejemplo, todas las cuentas incluyen SSH y soporte para varias versiones de PHP, así que el proceso se queda en unos minutos.

Requisitos previos antes de instalar Composer

Antes de ponerte manos a la obra, revisa que cumples esto en tu cuenta:

• Acceso SSH: imprescindible para ejecutar comandos en el servidor. Si tu plan no lo trae, habla con tu proveedor.
• PHP 7.4 o superior: lo compruebas en un segundo con php -v desde la terminal.
• Extensiones PHP habilitadas: Composer necesita phar, mbstring, json y openssl. Suelen venir activas de serie.
• Permisos de escritura: en tu directorio home o en la carpeta del proyecto.

Cómo instalar Composer en hosting paso a paso

Paso 1: Conéctate por SSH

Abre una terminal (o PuTTY, si estás en Windows) y conéctate:

ssh [email protected]

Paso 2: Descarga el instalador oficial

Desde tu directorio home, ejecuta:

php -r «copy(‘https://getcomposer.org/installer’, ‘composer-setup.php’);»

Este paso es corto, pero no te lo saltes: verifica la integridad del instalador comparando su hash SHA-384 con el publicado en la web oficial de Composer. Se hace así:

php -r «if (hash_file(‘sha384’, ‘composer-setup.php’) === trim(file_get_contents(‘https://composer.github.io/installer.sig’))) { echo ‘Instalador verificado’; } else { echo ‘Instalador corrupto’; }»

Paso 3: Instala Composer localmente en tu cuenta

Ahora ejecuta el instalador indicando dónde quieres el binario:

php composer-setup.php –install-dir=/home/usuario/bin –filename=composer

Después elimina el instalador y comprueba que todo funciona:

php composer-setup.php –quiet

composer –version

Gestionar dependencias PHP con composer.json

Crear el archivo composer.json

Todo gira alrededor del archivo composer.json, donde se declaran las dependencias del proyecto. Puedes crearlo a mano, sí, pero lo más cómodo es añadir paquetes con un solo comando:

composer require phpmailer/phpmailer

Eso genera el composer.json automáticamente, descarga la librería a la carpeta vendor/ y crea el autoload.php.

Usar el autoloader en tu código

<?php require ‘vendor/autoload.php’; use PHPMailer\PHPMailer\PHPMailer; $mail = new PHPMailer(); ?>

Comandos esenciales para el día a día

• composer install: instala las dependencias definidas en composer.lock. Es lo que quieres en producción.
• composer update: actualiza a las últimas versiones permitidas. En producción, cuidado con este.
• composer require paquete: añade una dependencia nueva.
• composer remove paquete: la elimina junto con sus referencias.
• composer dump-autoload: regenera el autoloader tras cambios manuales.

Buenas prácticas de seguridad en hosting compartido

1. Bloquea el acceso web a /vendor: añade Require all denied en el .htaccess de esa carpeta. Nadie debería poder ejecutar archivos internos desde el navegador.
2. No ejecutes composer update en producción: instala en local, prueba los cambios y sube el proyecto usando composer install, que respeta las versiones bloqueadas en composer.lock.
3. Limita la memoria disponible: si te saltan errores de memoria, prueba con COMPOSER_MEMORY_LIMIT=-1 composer install.
4. Audita dependencias periódicamente: el comando composer audit detecta vulnerabilidades conocidas en los paquetes instalados.

Errores comunes al instalar Composer en hosting y cómo resolverlos

Error de versión de PHP incompatible

Si Composer se queja de tu versión de PHP, cambia la versión desde el panel de control (en cPanel está en «Seleccionar versión de PHP») o define un alias en la línea de comandos, algo como php81 composer install.

Error «composer: command not found»

Casi siempre significa que el binario no está en el PATH. Usa la ruta completa (php /home/usuario/bin/composer) o ajusta la variable de entorno como vimos antes.

Límite de memoria o tiempo de ejecución agotado

En planes compartidos pasa a menudo. Ejecuta Composer con más memoria (php -d memory_limit=512M /home/usuario/bin/composer install) y, si sigue fallando, contacta con el soporte de tu proveedor.

Preguntas frecuentes

Conclusión: gestiona tus proyectos PHP con profesionalidad

Saber instalar Composer en hosting es lo que separa un proyecto PHP improvisado de uno mantenible, seguro y escalable. Y como has visto, el proceso es sencillo si tu proveedor ofrece SSH y PHP actualizado: descargar el instalador oficial, colocar el binario en tu cuenta y empezar a declarar dependencias en el composer.json. A partir de ahí, comandos como composer install o composer require te ahorrarán horas de gestión manual de librerías.

No olvides las buenas prácticas: bloquear el acceso a vendor/, no actualizar dependencias directamente en producción y auditar los paquetes con regularidad. Y si buscas un entorno donde todo esto funcione sin complicaciones, en RedServicio ofrecemos hosting con SSH incluido, PHP 8.x configurable desde el panel y soporte técnico 24/7 dispuesto a ayudarte con la instalación de Composer o con cualquier otro aspecto técnico de tu proyecto.