Este documento es una referencia rápida sobre la forma de reemplazar las diferentes partes de los paquetes de terceros.
Para más información sobre la sustitución de plantillas, consulta:
El enrutado en Symfony2 no se importa automáticamente. Si quieres incluir las rutas de algún paquete, entonces las debes importar manualmente desde algún lugar de tu aplicación (por ejemplo, app/config/routing.yml).
La forma más fácil de «sustituir» el enrutado de un paquete es no importarlo en absoluto. En lugar de importar el enrutado de un paquete de terceros, simplemente copia el archivo de enrutado a tu aplicación, modifica las rutas, e importarlo en su lugar.
Suponiendo que el paquete de terceros involucrado no utiliza los controladores como servicios (que casi siempre es el caso), fácilmente puede reemplazar los controladores a través de la herencia del paquete. Para más información, consulta Cómo utilizar la herencia de paquetes para redefinir partes de un paquete.
A fin de redefinir/extender un servicio, tienes dos opciones. En primer lugar, puedes configurar el parámetro que contiene el nombre de clase del servicio ajustándolo a tu propia clase en app/config/config.yml. Por supuesto, esto sólo es posible si definiste como parámetro el nombre de la clase en la configuración del servicio en el paquete que contiene el servicio. Por ejemplo, para redefinir la clase utilizada por el servicio traductor de Symfony, debes reajustar el parámetro translator.class. Saber exactamente cual parámetro cambiar posiblemente conlleve un poco de investigación. Para el traductor, el parámetro está definido y se utiliza en el archivo Resources/config/translation.xml en el núcleo de FrameworkBundle:
# app/config/config.yml
parameters:
translator.class: Acme\HelloBundle\Translation\Translator
<!-- app/config/config.xml -->
<parameters>
<parameter key="translator.class">Acme\HelloBundle\Translation\Translator</parameter>
</parameters>
// app/config/config.php
$container->setParameter('translator.class', 'Acme\HelloBundle\Translation\Translator');
En segundo lugar, si la clase no está disponible como un parámetro, te quieres asegurar de que —cuando se utilice el paquete— siempre se redefina la clase, o se tenga que modificar algo más allá de sólo el nombre de la clase, debes utilizar un pase del compilador:
// src/Acme/FooBundle/DependencyInjection/Compiler/OverrideServiceCompilerPass.php
namespace Acme\DemoBundle\DependencyInjection\Compiler;
use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
use Symfony\Component\DependencyInjection\ContainerBuilder;
class OverrideServiceCompilerPass implements CompilerPassInterface
{
public function process(ContainerBuilder $container)
{
$definition = $container->getDefinition('original-service-id');
$definition->setClass('Acme\DemoBundle\YourService');
}
}
En este ejemplo recuperaste la definición del servicio desde el servicio original, y ajustaste el nombre de la clase a tu propia clase.
Consulta Cómo trabajan los pases del compilador en los paquetes para más información sobre cómo usar los pases del compilador. Si quieres hacer algo más allá que sólo reemplazar la clase —como agregar una llamada a un método— sólo puedes usar el método de pase del compilador.
En curso...
Con el fin de sustituir un tipo de formulario, este se tiene que registrar como un servicio (lo cual significa que se etiqueta como «form.type»). A continuación, lo puedes modificar tal como lo harías para redefinir cualquier servicio, como se explica en Servicios y configuración. Esto, por supuesto, sólo funcionará si el tipo es referido por su alias en lugar de crear una instancia, por ejemplo:
$builder->add('name', 'custom_type');
rather than:
$builder->add('name', new CustomType());
En curso...
En curso...
