Utilice la función «Imprimir» al final de la página para crear un PDF.
PHP Composer es un gestor de paquetes para PHP. Te ayuda a integrar módulos de código externos (bibliotecas) en tus propios proyectos. Composer se encarga automáticamente de que se descarguen en la versión correcta todos los programas en segundo plano que requieren estos módulos (las denominadas dependencias).
En este artículo aprenderás a descargar, instalar e iniciar por primera vez Composer en tu espacio web de IONOS.
Requisitos
- Tarifa de hosting IONOS con acceso SSH
Si tu tarifa no admite el acceso SSH, puedes cambiar a otro contrato de hosting.
Aspectos importantes sobre la ejecución de comandos
Para poder utilizar Composer en tu espacio web, debes ejecutar scripts PHP a través de la línea de comandos (PHP CLI). Antes de copiar los comandos de estas instrucciones, ten en cuenta estos dos puntos:
1. Tu versión activa de PHP (IMPORTANTE)
Los siguientes ejemplos de código utilizan X.X. Debes sustituir X.X en todos los comandos que contengan la expresión phpX.X por la versión de PHP que utilices para tu proyecto web específico (p.ej.: php8.3 o php8.4).
Advertencia
Si utilizas aquí una versión incorrecta, Composer puede descargar bloques de código incompatibles que, en el peor de los casos, podrían provocar fallos en tu web.
2. El sufijo del comando (-cli)
Para que la ejecución en tu espacio web sea correcta, necesitas añadir el sufijo -cli (ejemplo para PHP 8.4: php8.4-cli).
Nota
No utilices el comando simple php sin un número de versión, ya que, de lo contrario, el script se ejecutará con una versión de PHP obsoleta. Encontrarás una lista completa de todas las versiones de PHP disponibles en el enlace al siguiente artículo: PHP-CLI: ejecutar scripts PHP usando la línea de comandos.
Instrucciones paso a paso
Paso 1) Establecer una conexión SSH
Inicia tu cliente SSH y conéctate a tu espacio web. Encontrarás instrucciones para diferentes sistemas operativos en la siguiente categoría del índice enlazado: configurar y gestionar accesos SSH.
Recomendación
Una vez establecida la conexión, verás la ventana de entrada de tu terminal. Para evitar errores tipográficos, te recomendamos que copies los comandos de los siguientes recuadros de código y los pegues en tu terminal. A continuación, pulsa la tecla Enter después de cada comando para ejecutarlo.
Paso 2) Preparar el directorio de instalación
Tu directorio de inicio (~) es al mismo tiempo el directorio htdocs. Este funciona como «Document Root», es decir, el directorio principal de tu web. Esto significa que, por norma general, cualquier persona puede acceder a los archivos de este directorio a través de Internet.
Por razones de seguridad, deberías crear un subdirectorio separado para Composer y protegerlo del acceso externo mediante un archivo .htaccess. El siguiente comando crea la carpeta y bloquea inmediatamente el acceso a través del navegador web:
mkdir ~/composer
echo "Require all denied" > ~/composer/.htaccess
cd ~/composer
Advertencia
Sin el archivo .htaccess, composer.phar podría ser accesible a través del navegador. Asegúrate de que el archivo .htaccess esté presente en el directorio.
Paso 3) Descargar el archivo de instalación de Composer
Descarga el archivo de instalación desde la página web oficial de Composer.
phpX.X-cli -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
Paso 4) Comparar la suma de comprobación (comprobación de seguridad)
Compara la suma de comprobación (también llamada «huella digital») del archivo descargado. De este modo, te aseguras de que el archivo no se haya dañado ni manipulado durante la transferencia y de que se trate del archivo original. Dado que la suma de comprobación cambia con cada actualización, recuperamos el «hash» actual de forma automatizada desde la infraestructura de Composer.
Ejecuta las dos líneas una tras otra:
EXPECTED_CHECKSUM="$(phpX.X-cli -r 'copy("https://composer.github.io/installer.sig", "php://stdout");')"
phpX.X-cli -r “if (hash_file('sha384', 'composer-setup.php') === '$EXPECTED_CHECKSUM') { echo 'Installer Verified'; } else { echo 'Installer Corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;”
Nota
Si en el terminal aparece el mensaje Installer Verified, el archivo es seguro y puedes continuar con la instalación. Si aparece Installer Corrupt, el archivo se habrá eliminado automáticamente por estar defectuoso o comprometido. En tal caso, descarga el archivo de nuevo.
Paso 5) Instalar la herramienta Composer
Ejecuta el archivo de instalación.
phpX.X-cli composer-setup.php
Tras la instalación, el archivo composer.phar se encuentra en el directorio al que se ha cambiado en el paso 2. La extensión .phar significa «PHP Archive», que puedes considerar como un archivo de programa ejecutable para PHP.
Paso 6) Eliminar el archivo de instalación (limpiar)
El archivo composer-setup.php ya no es necesario. Para mantener limpio tu espacio web, deberías eliminarlo.
phpX.X-cli -r "unlink('composer-setup.php');"
Paso 7) Comprobar la instalación
Comprueba la instalación ejecutando Composer directamente. Asegúrate de que se encuentra en el directorio en el que está composer.phar (consulta el paso 2).
phpX.X-cli composer.phar
Como resultado, se muestra un resumen de todos los comandos Composer disponibles.
Paso 8) Configurar alias (comando corto) - opcional
Para evitar tener que acceder siempre a Composer con la ruta de archivo completa y larga, puedes crear un alias. Se trata de un atajo definido por el usuario para la línea de comandos.
Utiliza el siguiente comando para introducir la abreviatura «composer» de forma permanente en tu archivo de configuración personal (.bash_profile):
echo "alias composer='phpX.X-cli ~/composer/composer.phar'" >> ~/.bash_profile
Este alias entrará en vigor automáticamente en tu próximo inicio de sesión SSH. Para activarlo inmediatamente en la ventana actual, recarga la configuración con este comando:
source ~/.bash_profile
El comando composer será suficiente para iniciar la herramienta desde cualquier directorio.
Comprobar el resultado
La instalación se ha realizado correctamente si, tras ejecutar Composer, se muestra una lista de comandos disponibles y la versión de Composer instalada.
Para mantener Composer actualizado, utiliza el comando self-update. Si has configurado el alias del paso 8, puedes utilizar composer self-update. De lo contrario, ejecuta el comando directamente en el directorio de instalación:
phpX.X-cli composer.phar self-update
Solución de problemas
El terminal muestra el mensaje de error «command not found»
Probablemente copiaste el comando literalmente, incluyendo el marcador de posición (p.ej.: phpX.X-cli). Por favor, sustituye la X.X en el comando por la versión PHP real de tu proyecto web (p.ej.: php8.2-cli o php8.4-cli) y ejecuta el comando de nuevo.No se encuentra el comando «composer»
El atajo composer solo está disponible si configuraste el alias del paso 8. Utiliza el comando cat ~/.bash_profile para comprobar si el alias se ha introducido correctamente. A continuación, inicia sesión de nuevo a través de SSH o ejecuta source ~/.bash_profile para que se carguen los cambios. Accede a Composer sin alias directamente a través del comando PHP CLI y composer.phar (ver paso 8).La suma de comprobación no coincide («Installer Corrupt»)
El archivo descargado era defectuoso o estaba comprometido, por lo que se ha eliminado automáticamente. Por favor, vuelve a realizar el paso 3 (descarga) y el paso 4 (comprobación).Mensajes de error de PHP al ejecutar Composer
Asegúrate de no haber utilizado por error una versión de PHP incorrecta en el comando. Debes indicar exactamente la versión de PHP que utiliza tu proyecto web (ver sección «Aspectos importantes sobre la ejecución de comandos»).