martes 3 diciembre 2024

Cómo usar configuraciones globales con Composer

Composer permite gestionar configuraciones globales que se aplican a nivel de usuario en todos los proyectos. Estas configuraciones se almacenan en el archivo config.json, ubicado en el directorio global de Composer, y permiten ajustar parámetros como proxies, tiempo de espera, rutas de instalación global, entre otros.

¿Qué son las configuraciones globales de Composer?

Las configuraciones globales en Composer definen ajustes que afectan el comportamiento de Composer en todos los proyectos del usuario. Estas configuraciones son útiles para personalizar aspectos generales como la ubicación de paquetes globales, ajustes de rendimiento y configuraciones de red.

El archivo de configuración global se encuentra en:

Linux/MacOS: ~/.composer/config.json
Windows: %APPDATA%\Composer\config.json

Configuración global básica

Para modificar configuraciones globales, usa el siguiente comando:

composer config --global <clave> <valor>

Por ejemplo, para configurar un proxy global:

composer config --global http-proxy http://proxy.ejemplo.com:8080

Parámetros comunes en configuraciones globales

Clave	Descripción
`process-timeout`	Tiempo de espera para operaciones en segundos.
`preferred-install`	Método de instalación (por ejemplo, `dist` o `source`).
`http-basic`	Credenciales para repositorios protegidos por autenticación HTTP.
`github-oauth`	Token de autenticación para acceso a GitHub.
`disable-tls`	Desactiva la verificación SSL (no recomendado por seguridad).
`vendor-dir`	Cambia la ubicación de la carpeta `vendor` para todos los proyectos.

Ejemplo de archivo `config.json`

El siguiente ejemplo muestra un archivo config.json global típico:

{
  "process-timeout": 300,
  "preferred-install": "dist",
  "github-oauth": {
    "github.com": "ghp_1234567890abcdef1234567890abcdef1234"
  },
  "http-basic": {
    "repo.ejemplo.com": {
      "username": "usuario",
      "password": "contraseña"
    }
  }
}

Cómo verificar las configuraciones globales

Para listar todas las configuraciones globales actuales, utiliza:

composer config --global --list

Esto mostrará todas las claves y valores configurados a nivel global.

Restaurar configuraciones globales

Si necesitas eliminar una configuración global específica, usa:

composer config --global --unset <clave>

Por ejemplo, para eliminar un proxy:

composer config --global --unset http-proxy

Ejemplo práctico: Configurar la instalación global

Puedes cambiar el directorio predeterminado donde se instalan los paquetes globales:

composer config --global home ~/.composer-global

Ahora, los paquetes instalados globalmente estarán en ~/.composer-global.

Referencia oficial

Consulta más detalles en la documentación oficial de Composer sobre configuración.

Etiquetas:

php composer

Creado por:

Jorge García

Fullstack developer