Generalidades sobre la instalación de Composer

Composer es una herramienta de gestión de dependencias para proyectos PHP. Te permite declarar las bibliotecas que tu proyecto requiere y las instala/actualiza por ti.

Está implementado como un archivo PHAR (PHP Archive). Phar está habilitado de manera predeterminada en tu servidor de DreamHost. Lo puedes confirmar al ejecutar el siguiente comando por SSH:

[server]$ php -m | grep Phar
Phar

Algunos proyectos PHP sugieren que se use Composer para administrar bibliotecas externas durante la instalación. MediaWiki es uno de esos ejemplos, al indicarlo en sus instrucciones de instalación:

Si deseas que tus comandos se ejecuten usando una versión específica de PHP, mira el siguiente artículo:

• Cambiar la versión de PHP que usa shell

Haz clic en el siguiente enlace para encontrar más detalles:

• Instalar Composer

Instalar Composer a nivel local es buena idea si sólo tienes que mantener un proyecto.

1. Inicia sesión por SSH en tu servidor.
2. Navega al directorio de tu proyecto.

   [server]$ cd ~/<path-to-your-project>

   Reemplaza <path-to-your-project> con la ruta a tu proyecto. Si el directorio del proyecto se llama proyecto y está en el dominio example.com, la ruta sería example.com/proyecto.

3. 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

4. Si funciona, verás el siguiente mensaje:

   #!/usr/bin/env php All settings correct for using Composer
   Downloading... 
   
   Composer successfully installed to: /home/username/example.com/project/composer.phar 
   
   Use it: php composer.phar
   

   Esto descarga el archivo composer.phar.

1. Inicia sesión por SSH en tu servidor.
2. Navega al directorio de usuario.
   

   [server]$ cd ~

3. Crea un directorio para la instalación. Puedes escoger cualquier nombre que sea válido, en las siguientes instrucciones le llamaremos ~/.php/composer.

   [server]$ mkdir -p ~/.php/composer

4. Navega al directorio de la instalación.

   [server]$ cd ~/.php/composer

5. 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

6. Revisa el artículo crear y editar un archivo por SSH para que encuentres instrucciones sobre cómo editar tu archivo existente .bash_profile ubicado en el directorio home de tu usuario. Agrega lo siguiente al archivo composer.phar.

   export PATH=/home/username/.php/composer:$PATH

   Reemplaza username con tu usuario shell.

7. Guarda el archivo y ciérralo.
8. Ejecuta el siguiente comando para actualizar el archivo .bash_profile:

   [server]$ . ~/.bash_profile

9. Renombra el archivo de composer para que sea más fácil de manejarlo.

   [server]$ mv ~/.php/composer/composer.phar ~/.php/composer/composer

Si instalaste Composer a nivel local, entonces, mientras estás en el directorio del proyecto invocarás a Composer de esta manera:

[server]$ php composer.phar <composer-command>

Si instalaste Composer a nivel global, deberías invocar a Composer de esta manera:

[server]$ composer <composer-command>

En cualquier caso, reemplaza <composer-command> con el comando de composer que quieras ejecutar. Puedes encontrar una lista de los comandos de Composer aquí en la documentación de Composer.

Al ejecutar composer, puede que encuentres el siguiente error:

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 tu archivo phprc que hacen referencia a Phar que deben 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.1, corre el siguiente comando:

[server]$ cat ~/.php/8.1/phprc

Si ves que en alguna de las líneas se menciona a Phar, elimínalas, y luego elimina los procesos para actualizar el archivo.

• Mi archivo phprc no se actualiza