Diferencia entre revisiones de «Usuario:ManuelRomero/ProgramacionWeb/Composer»

https://medium.com/tech-tajawal/php-composer-the-autoloader-d676a2f103aa

¿Qué es Composer?

Del mismo modo que un director de orquesta coordina a todos los instrumentos para que la música suene de forma armoniosa, Composer actúa como un orquestador del proyecto PHP. Su función principal es gestionar de forma unificada todos los paquetes, librerías y dependencias que una aplicación necesita para funcionar correctamente.

¿Qué hace Composer?

Entre sus funciones principales, Composer me permite: Gestionar automáticamente la autocarga (autoload) de las clases, evitando tener que hacer includes o requires manuales. Instalar librerías y paquetes de terceros dentro de mi proyecto de forma rápida, segura y organizada.

{{MRM_Definicion|Title=Otras funcionalidades importantes de Composer| Además del autoload y la instalación de dependencias, Composer también:

• Mantiene un fichero de metainformación del proyecto en composer.json, donde se define:

get_included_files()

• Sería ideal tener un sistema que nos permitiera indicar dónde se encuentran las clases, generar automáticamente la autocarga y mantenerlo todo organizado.*

Para eso existe Composer, que incorpora diferentes estrategias para el autoload: classmap y PSR-4.

Puntos clave

Cada clase en su propio fichero* El fichero debe llamarse igual que la clase*

Usando Composer con classmap

• Creamos una estructura de directorios, por ejemplo:*

• Ejemplo de clase:*

<?php
class B {
    public function __toString() {
        return "Hola desde la clase B";
    }
}

• Creamos el fichero composer.json indicando que Composer debe escanear el directorio Clases/:*

{
  "autoload": {
    "classmap": [
      "Clases"
    ]
  }
}

• Actualizamos Composer para generar la carga automática:*

composer update

• Composer crea automáticamente la carpeta vendor/ y genera el fichero de autocarga.*

• Ahora sólo tenemos que incluir el autoload en nuestro proyecto:*

<?php
require "vendor/autoload.php";

• Si añadimos nuevos ficheros, recuerda regenerar el autoload:*

composer dumpautoload

---

Usando PSR-4

• PSR-4 es el método moderno y recomendado de autocarga. Usa los namespaces para localizar las clases automáticamente sin necesidad de regenerar el autoload cada vez.*

• Referencias recomendadas:*

https://styde.net/curso-de-laravel-5-que-es-psr-4-y-uso-de-los-namespaces/ https://diego.com.es/namespaces-en-php https://www.php.net/manual/es/language.namespaces.php

Espacio de nombres

• Un namespace es una forma de organizar clases, funciones e interfaces evitando conflictos entre nombres.*
• Es equivalente a la organización en directorios del sistema de ficheros.*

Ejemplo equivalente en archivos reales:

/home/profesor/dwes/notas.ods
/home/profesor/bd/notas.ods

Puedes tener dos clases con el mismo nombre si pertenecen a distintos namespaces.

Objetivo

Los namespaces de PHP permiten agrupar clases, funciones, interfaces y constantes relacionadas.

Declarar un namespace

• El namespace debe ser la primera línea del fichero (sin espacios previos).*

<?php
namespace MiProyecto;

• También puede tener varios niveles separados por barras invertidas \':*

<?php
namespace MiProyecto\Nivel1\Subnivel2;

Comentarios sobre namespaces

Cada namespace suele corresponder a un directorio. No es obligatorio que coincidan exactamente, pero es buena práctica.*

---

PSR-4 en Composer

• PSR-4 es más potente y elegante que classmap, y no requiere regenerar el autoload cuando se añaden nuevas clases.*

• Se basa completamente en los namespaces.*

Ejemplo de configuración en composer.json:

{
  "autoload": {
    "psr-4": {
      "MiProyecto\\": "src/"
    }
  }
}

Esto significa:

• Las clases con namespace **MiProyecto** se cargarán desde la carpeta **src/**
• La clase:

namespace MiProyecto\Modelos;

se ubica en

src/Modelos/Usuario.php

• Tras crear o modificar el composer.json, sólo debes ejecutar:*

composer dumpautoload

PSR-4 permite:

• Organizar clases por módulos y carpetas
• Crear proyectos escalables
• Evitar conflictos de nombres
• Mejorar la legibilidad y mantenibilidad del código

y es el estándar moderno utilizado por:

• Laravel
• Symfony
• CodeIgniter 4
• Doctrine
• La mayoría del ecosistema PHP actual

Comparativa: classmap vs PSR-4

A la hora de configurar la carga automática de clases con Composer, existen dos métodos principales: classmap y PSR-4. Ambos funcionan, pero sirven para necesidades diferentes.

Ejemplo visual: cómo piensan los dos sistemas

Classmap (método antiguo o heredado)

Composer crea un “mapa” con las rutas exactas.

{
  "autoload": {
    "classmap": ["Clases/"]
  }
}

Resultado interno:

B => Clases/B.php
C => Clases/C.php
MiClaseEspecial => Clases/OtraCarpeta/MiClaseEspecial.php

Cada vez que añades una clase nueva → composer dumpautoload

---

PSR-4 (método moderno)

Mapea namespaces a carpetas:

{
  "autoload": {
    "psr-4": {
      "MiProyecto\\": "src/"
    }
  }
}

Reglas:

namespace MiProyecto\Modelos;
 
src/Modelos/Usuario.php

Añades una clase → no hace falta hacer nada (Composer la encontrará automáticamente).