Generalidades
Este artículo te guía a través del proceso de instalación de Composer en un servidor web de DreamHost.
Antecedentes
Composer es una herramienta de gestión de dependencias para proyectos PHP. Te permite declarar las bibliotecas que requiere tu proyecto y las instala o actualiza por ti. Se implementa como un archivo PHAR (archivo PHP), que ya está habilitado de forma predeterminada en tu servidor DreamHost. Puedes confirmarlo ejecutando el siguiente comando a través de SSH:
[server]$ php -m | grep Phar Phar
Cambiar la CLI PHP predeterminada que utiliza tu shell
Revisa este artículo si deseas que tus comandos tengan como valor predeterminado una versión específica de PHP.
Cómo instalar Composer
Las siguientes secciones explican cómo realizar la instalación local o global en tu servidor web.
Instalar Localmente
Se recomienda instalar Composer a nivel local si sólo tienes que mantener un proyecto.
- Inicia sesión por SSH en tu servidor.
- Navega al directorio de tu proyecto.
[server]$ cd ~/<path-to-your-project>
- Reemplaza <path-to-your-project> con la ruta a tu proyecto. Por ejemplo, si el directorio del proyecto se llama proyecto y está en el dominio example.com, la ruta sería example.com/project.
- Ejecuta el instalador de Composer.
[server]$ curl -sS https://getcomposer.org/installer | php
-
Si eso no funciona, entonces intenta lo siguiente:
[server]$ php -r "readfile('https://getcomposer.org/installer');" | php
Si funciona, verás este mensaje:
Composer successfully installed to: /home/username/example.com/project/composer.phar Use it: php composer.phar
-
Si eso no funciona, entonces intenta lo siguiente:
Instalar Globalmente
Se recomienda realizar la instalación global si vas a utilizar Composer con varios proyectos.
- Inicia sesión por SSH en tu servidor.
- Navega al directorio de usuario.
[server]$ cd ~
- Crea un directorio para la instalación. Puedes escoger cualquier nombre que sea válido, en las siguientes instrucciones usa el directorio ~/.php/composer.
[server]$ mkdir -p ~/.php/composer
- Cambia al directorio de la instalación.
[server]$ cd ~/.php/composer
- Ejecuta el instalador de Composer.
[server]$ curl -sS https://getcomposer.org/installer | php
-
Si eso no funciona, entonces intenta lo siguiente:
[server]$ php -r "readfile('https://getcomposer.org/installer');" | php
-
- Agrega la siguiente línea al archivo .bash_profile ubicado en el directorio principal del usuario. Reemplaza username con tu usuario shell.
-
export PATH=/home/username/.php/composer:$PATH - Guarda el archivo y ciérralo.
- Actualiza el archivo .bash_profile:
[server]$ . ~/.bash_profile
- Renombra el archivo de composer para que sea más fácil de manejarlo.
[server]$ mv ~/.php/composer/composer.phar ~/.php/composer/composer
Usar Composer
Invocarás Composer de forma diferente dependiendo de si lo instalaste local o globalmente.
En cualquier caso, reemplaza <composer-command> con el comando de Composer que deseas ejecutar. Los comandos de Composer se pueden encontrar enumerados en la documentación de Composer.
Localmente
Si instalaste Composer localmente, invócalo mientras estás en el directorio del proyecto.
[server]$ php composer.phar <composer-command>
Globalmente
Si instalaste Composer globalmente, invócalo usando esta sintaxis desde cualquier directorio.
[server]$ composer <composer-command>
Solución de problemas
Es posible que veas el siguiente error al ejecutar Composer:
PHP Fatal error: Uncaught Error: Class 'Phar' not found
Phar ya está habilitado de manera predeterminada, por lo que este error generalmente significa que hay líneas en el archivo phprc que hacen referencia a Phar y que deberían eliminarse. Primero, verifica qué versión de PHP está usando tu shell.
[server]$ php -v
A continuación, revisa el archivo phprc correspondiente a esa versión. Por ejemplo, si tu Shell usa PHP 8.3, corre el siguiente comando:
[server]$ cat ~/.php/8.3/phprc
Si ves que en alguna de las líneas se menciona a Phar, elimínalas, y luego elimina cualquier proceso para actualizar el archivo.