Cómo instalar y usar componentes de Symfony2

Si estás comenzando un nuevo proyecto (o ya tienes uno) que utilizará uno o más componentes, la forma más fácil de integrar todo es con Composer. Composer es lo suficientemente inteligente como para descargar el/los componente(s) que necesita(s) y tiene cuidado de cargalos automáticamente para que puedas empezar a utilizar las bibliotecas de inmediato.

Este artículo te llevará a través del uso del El componente Finder, aunque esto se aplica a la utilización de cualquier componente.

Usando el componente Finder

1. Si vas a crear un nuevo proyecto, crea un nuevo directorio vacío para él.

2. Crea un nuevo archivo llamado composer.json y pega el siguiente código en él:

{
    "require": {
        "symfony/finder": "2.2.*"
    }
}

Si ya tienes un archivo composer.json, sólo agrégale esta línea. Posiblemente también necesites ajustar la versión (p. ej. 2.1.1 o 2.2.*).

Puedes averiguar el nombre de los componentes y sus versiones en packagist.org.

3. Instala composer si no está presente en tu sistema:

4. Descarga las bibliotecas de proveedores y genera el archivo vendor/autoload.php:

$ php composer.phar install

5. Escribe tu código:

Una vez que Composer ha descargado el/los componente(s), todo lo que necesitas hacer es incluir el archivo vendor/autoload.php generado por Composer. Este archivo se preocupa de cagar automáticamente todas las bibliotecas a modo que las puedas utilizar inmediatamente:

// Archivo: src/script.php

// actualiza esto a la ruta al directorio «vendor/», relativa a este archivo
require_once '../vendor/autoload.php';

use Symfony\Component\Finder\Finder;

$finder = new Finder();
$finder->in('../data/');

// ...

Truco

Si quieres utilizar todos los componentes de Symfony2, entonces en vez de añadirlos uno por uno:

{
    "require": {
        "symfony/finder": "2.2.*",
        "symfony/dom-crawler": "2.2.*",
        "symfony/css-selector": "2.2.*"
    }
}

puedes usar:

{
    "require": {
        "symfony/symfony": "2.2.*"
    }
}

Esto incluirá el paquete y bibliotecas puente, el cual posiblemente no necesites de hecho.

¿Ahora qué?

Ahora que el componente está instalado y se carga automáticamente, lee la documentación específica del componente para descubrir más sobre cómo utilizarlo.

¡Y diviértete!